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Avant-propos 



Le livre que vous tenez dans vos mains a une longue histoire derriere lui. Et pour 
cause : il a mis plus de dix ans a murir avant de voir le jour. Comment peut-on en 
arriver a preparer un livre pendant dix longues annees ? Un petit retour en arriere 
s'impose. 

Je suis un passionne de nouvelles technologies parmi tant d'autres. J'ai eu mon premier 
ordinateur entre les mains juste avant de rentrer au college. C'etait a ce moment le 
lancement en grandes pompes de Windows 95. 

J'ai immediatement voulu aller plus loin, savoir « comment <ja fonctionne a l'interieur ». 
Mon premier reflexe a ete d'ecumer les librairies de quartier et plus particulierement 
leur section micro- informatique deja bien developpee. Tout (ou presque) me faisait 
envie : « Creez votre site web en HTML en 50 minutes », « Developpez vos propres 
programmes facilement avec Visual Basic », etc. Des promesses qui, a elles seules, 
auraient pu avoir raison de mon argent de poche. 

C'est en lisant la quatrieme de couverture que les choses ont commence a coincer : « Ce 
livre est destine aux personnes ayant deja une bonne experience en programmation ». 
Pas de panique. II suffit de trouver celui qui s'adresse aux debutants comme moi. Je 
repose le livre sur les etalages et je tente d'en sortir un autre. Puis un autre. Puis encore 
un autre. Jusqu'a me rendre a l'evidence : pour apprendre a programmer, il faut deja 
savoir programmer. 

Histoire de ne pas avoir fait le trajet pour rien, je repartirai quand meme avec un 
livre ou deux sous les bras, ceux qui semblaient les plus corrects du lot. Je leur rends 
hommage ici : c'est avec eux que j'ai demarre et j'ai beaucoup appris a leur lecture. Mais 
en les relisant avec un peu de recul quelques mois plus tard, j'ai fini par m'apercevoir 
de certaines incoherences : un chapitre simple sur l'installation d'un logiciel qui aurait 
du etre place tout au debut, des codes source sans explications, quand ce n'etait pas 
carrement un mot important utilise tout au long du livre et defini vers la fin ! 

La critique etait facile, mais il me fallait prouver que l'on pouvait faire plus clair et plus 
simple. J'ai done entrepris de reformuler mon premier livre tel que j'aurais souhaite 
le lire en creant mon premier site web. 

C'etait il y a dix ans presque jour pour jour a la sortie de ce livre. 



CHAPITRE 0. AVANT-PROPOS 



Qu'est-ce que ce livre vous propose ? 

Bien des annees se sont ecoulees depuis la redaction des premiers cours. Dans cet inter- 
valle de temps, j'ai suivi des etudes d'ingenieur en informatique puis j'ai ete professeur 
de langage C dans l'enseignement superieur. 

Tout ceci m'a amene a construire un plan de cours adapte aux debutants, progressif et 
concret. Celui-ci est constitue de quatre parties que vous retrouverez dans cet ouvrage : 



1. Les bases de la programmation en C : nous demarrerons en douceur en 
decouvrant ce qu'est la programmation et a quoi sert le langage C qui fait l'objet 
de ce livre. Nous installerons les outils necessaires au programmeur adaptes a 
votre systeme d'exploitation : Windows, Mac OS X ou Linux. Nous realiserons 
nos premiers programmes simples et pourrons pratiquer en realisant un petit jeu 
des la fin de cette partie. 

2. Techniques « avancees » du langage C : nous etudierons des concepts plus 
avances et plus complexes du C. Ceux-ci, bien que d'un niveau plus eleve, sont 
indispensables a la bonne comprehension du langage : pointeurs, tableaux, struc- 
tures, chaines de caracteres, etc. Le niveau reste progressif mais le cours deman- 
dera plus d'attention de votre part a partir de cette seconde partie, soyez-en 
simplement prevenus. 

3. Creation de jeux 2D en SDL : apres avoir acquis l'essentiel des connaissances 
necessaires pour programmer en C, il nous sera possible de nous amuser en creant 
nous-memes des programmes complets tels que des jeux et des lecteurs audio. 
Pour y parvenir, nous utiliserons une « extension » du langage C que l'on appelle 
la SDL. 

4. Les structures de donnees : pour aller plus loin, nous decouvrirons des me- 
thodes de programmation specifiques dans cette derniere partie. Nous manipule- 
rons des donnees en memoire a l'aide de structures personnalisees et intelligentes, 
ce qui vous permettra d'augmenter en efficacite lorsque vous realiserez vos futurs 
programmes. 



Comment lire ce livre ? 
Suivez l'ordre des chapitres 

Lisez ce livre comme on lit un roman. II a ete congu de cette fagon. 

Contrairement a beaucoup de livres techniques ou il est courant de lire en diagonale et 
de sauter certains chapitres, ici il est tres fortement recommande de suivre l'ordre du 
cours, a moins que vous ne soyez deja un peu experimente. 



COMMENT LIRE CE LIVRE ? 



Pratiquez en meme temps 

Pratiquez regulierement. N'attendez pas d'avoir fini la lecture de ce livre pour allumer 
votre ordinateur et faire vos propres essais. 

Le livre comporte plusieurs T.P. 1 qui vous invitent a creer votre propre programme en 
suivant une serie de consignes. C'est bien, mais ne vous en contentez pas. Essayez les 
codes source que je vous propose tout au long du cours. Modifiez-les un tout petit peu, 
puis de plus en plus jusqu'a vous sentir a l'aise. Une fois les T.P. termines, essayez de 
realiser les ameliorations suggerees ainsi que celles qui vous passent par la tete. Vous 
progresserez ainsi beaucoup plus vite que vous ne l'imaginiez. 

Utilisez les codes web ! 

Afin de tirer parti du Site du Zero dont est issu ce livre, celui-ci vous propose ce qu'on 
appelle des « codes web ». Ce sont des codes a 6 chiffres a rentrer sur une page du Site 
du Zero pour etre automatiquement redirige vers un site web sans avoir a en recopier 
l'adresse. 

Pour utiliser les codes web, rendez-vous sur la page suivante 2 : 

http://www. siteduzero . com/codeweb.litml 

Un formulaire vous invite a rentrer votre code web. Faites un premier essai avec le code 
ci-dessous : 

> ( Code web : 123456) 

Ces codes web ont deux interets : 

- vous faire telecharger les codes source inclus dans ce livre, ce qui vous evitera d'avoir 
a recopier certains codes un peu longs ; 

- vous rediriger vers les sites web presentes tout au long du cours. 

Ce systeme de redirection nous permet de tenir a jour le livre que vous avez entre les 
mains sans que vous ayez besoin d'acheter systematiquement chaque nouvelle edition. 
Si un site web change d'adresse, nous modifierons la redirection mais le code web a 
utiliser restera le meme. Si un site web disparait, nous vous redirigerons vers une page 
du Site du Zero expliquant ce qui s'est passe et vous proposant une alternative. 

En clair, c'est un moyen de nous assurer de la perennite de cet ouvrage sans que vous 
ayez a faire quoi que ce soit ! 



1. Travaux Pratiques 

2. Je vous suggere d'ailleurs de l'ajouter a vos favoris. 



ill 



CHAPITRE 0. AVANT-PROPOS 



Du Site du Zero au Livre du Zero 

A l'epoque ou j'ai souhaite rediger mes premiers cours pour debutants, mon premier 
reflexe a ete de creer un site web car c'etait pour moi le moyen le plus simple de publier 
mes ecrits 3 . II fut decide que le site s'appellerait le « Site du Zero ». . . parce qu'on y 
apprendrait tout a partir de zero. 

Sans moyens publicitaires autres que le bouche a oreille, mais avec beaucoup de moti- 
vation et de passion, www. siteduzero. com s'est fait au fil des annees un veritable nom 
sur le Web. A tel point que j'ai fini par decouvrir qu'il etait connu et recommande par 
des professeurs en informatique, mais aussi utilise comme support de cours par leurs 
eleves ! 

Le site s'est fortement developpe et est devenu plus qu'un site de cours en ligne pour 
debutants. II regroupe aujourd'hui plus de 170 000 membres formidables qui echangent 
et s'entraident sur les forums mais prennent aussi part a la redaction des cours de 
fagon desinteressee. La seule consigne en vigueur sur le site est la seule que j'aie jamais 
suivie : se mettre a la place du lecteur debutant que nous avons tous ete. 

Cela fait longtemps que je souhaite un retour aux sources, dans ces librairies ou j'ai 
moi-meme ete perdu. Le Livre du Zero est le moyen ideal de boucler la boucle. 



A l'attention de ceux qui ne connaissent pas le Site du Zero 

Si vous ne faites pas partie des visiteurs du Site du Zero 4 , vous vous demandez a juste 
titre si ce livre est fait pour vous. 

Comme vous l'aurez sans doute compris, ce livre est avant tout destine aux debutants. 
Vous y trouverez neanmoins aussi votre compte si vous avez deja de l'experience en 
programmation dans d'autres langages et que vous souhaitez decouvrir le C. 

Toutes les notions a connaitre pour demarrer dans la programmation seront detaillees, 
en privilegiant les exemples aux definitions theoriques. Le cours est d'ailleurs particu- 
lierement fourni en schemas comme vous pourrez le constater. 

Lisez le premier chapitre pour decider si vous accrochez et comprenez ce qui s'y dit. 
La seule competence reellement requise est de savoir allumer un ordinateur 5 . Je me 
charge de vous expliquer tout le reste : de l'installation des logiciels necessaires pour 
programmer a l'explication des commandes qui permettent de creer des programmes, 
en passant par les conseils et les bonnes pratiques qui vous feront gagner du temps. 

Vous noterez que je m'exprime toujours a la premiere personne. C'est ma fagon de faire. 
Imaginez d'une certaine maniere que nous sommes vous et moi dans la meme salle et 
que je suis votre professeur. Je vous parle directement et je reponds a vos questions en 



3. Et ca Test d'ailleurs toujours, c'est amusant de voir que cela n'a pas change. Le Web est plus 
que jamais un formidable espace d'expression et doit le rester. 

4. Que Ton appelle d'ailleurs les « Zeros », selon une logique implacable qui ne vous aura pas 
echappe. ;-) 

5. Ce n'est pas une plaisanterie, c'est la raison d'etre de ce livre et c'est pour cela qu'on l'appelle 
le « Livre du Zero ». 

iv 
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Premiere partie 

Les bases de la programmation 

en C 



Chapitre 



1 



Vous avez dit programmer? 



v 



ous avez deja entendu parler de programmation et nul doute que si vous avez ce 
livre entre les mains, c'est parce que vous voulez « enfin » comprendre comment ca 
fonctionne. 



Mais programmer en langage C. . . ca veut dire quoi ? Est-ce que c'est bien pour com- 
mencer? Est-ce que vous avez le niveau pour programmer? Est-ce qu'on peut tout faire 
avec? 

Ce chapitre a pour but de repondre a toutes ces questions apparemment betes et pourtant 
tres importantes. Grace a ces questions simples, vous saurez a la fin de ce premier chapitre 
ce qui vous attend. C'est quand meme mieux de savoir a quoi sert ce que vous allez 
apprendre, vous ne trouvez pas? 
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CHAPITRE 1. VOUS AVEZ DIT PROGRAMMER ? 



Programmer, c'est quoi ? 

On commence par la question la plus simple qui soit, la plus basique de toutes les 
questions basiques. Si vous avez l'impression de deja savoir tout ca, je vous conseille 
de lire quand meme, <ja ne peut pas vous faire de mal ! Je pars de zero pour ce cours, 
done je vais devoir repondre a la question : 




<? 



Que signifie le mot « programmer » ? 



Programmer signifie realiser des « programmes informatiques ». Les programmes de- 
mandent a l'ordinateur d'effectuer des actions. 

Votre ordinateur est rempli de programmes en tous genres : 

- la calculatrice est un programme ; 

- votre traitement de texte est un programme ; 

- votre logiciel de « chat » est un programme ; 

- les jeux video sont des programmes (cf. fig. 1.1, le celebre jeu Half-Life 2). 




Figure 1.1 - Le jeu Half-Life 2 a ete programme en C++, un langage voisin du C 

En bref, les programmes sont partout et permettent de faire a priori tout et n'importe 
quoi sur un ordinateur. Vous pouvez inventer un logiciel de cryptage revolutionnaire si 
ga vous chante, ou realiser un jeu de combat en 3D sur Internet, peu importe. Votre 
ordinateur peut tout faire (sauf le cafe, mais j'y travaille). 

Attention ! Je n'ai pas dit que realiser un jeu video se faisait en claquant des doigts. J'ai 
simplement dit que tout cela etait possible, mais soyez surs que ca demande beaucoup 
de travail. 



PROGRAMMER, DANS QUEL LANG AGE \ 



Comme vous debutez, nous n'allons pas commencer en realisant un jeu 3D. Ce serait 
suicidaire. Nous allons devoir passer par des programmes tres simples. Une des pre- 
mieres choses que nous verrons est comment afficher un message a I'ecran. Oui, je sais, 
ga n'a rien de transcendant, mais rien que ga croyez-moi, ce n'est pas aussi facile que 
ga en a l'air. 

Ca impressionne moins les amis, mais on va bien devoir passer par la. Petit a petit, 
vous apprendrez suffisamment de choses pour commencer a realiser des programmes 
de plus en plus complexes. Le but de ce cours est que vous soyez capables de vous en 
sortir dans n'importe quel programme ecrit en C. 

Mais tenez, au fait, vous savez ce que c'est vous, ce fameux « langage C » ? 



Programmer, dans quel langage ? 

Votre ordinateur est une machine bizarre, c'est le moins que l'on puisse dire. On ne 
peut s'adresser a lui qu'en lui envoyant des et des 1. Ainsi, si je traduis « Fais le 
calcul 3 + 5 » en langage informatique, ga pourrait donner quelque chose comme 1 : 

0010110110010011010011110 

Ce que vous voyez la, c'est le langage informatique de votre ordinateur, appele langage 
binaire (retenez bien ce mot!). Votre ordinateur ne connait que ce langage-la et, 
comme vous pouvez le constater, c'est absolument incomprehensible. 

Done voila notre premier vrai probleme : 

)^ Comment parler a I'ordinateur plus simplement qu'en binaire avec des et 
J des 1 ? 

Votre ordinateur ne parle pas l'anglais et encore moins le frangais. Pourtant, il est 
inconcevable d'ecrire un programme en langage binaire. Meme les informaticiens les 
plus fous ne le font pas, c'est vous dire ! 

Eh bien l'idee que les informaticiens ont eue, c'est d'inventer de nouveaux langages 
qui seraient ensuite traduits en binaire pour I'ordinateur. Le plus dur a faire, c'est 
de realiser le programme qui fait la « traduction ». Heureusement, ce programme a 
deja ete ecrit par des informaticiens et nous n'aurons pas a le refaire (ouf !). On va 
au contraire s'en servir pour ecrire des phrases comme : « Fais le calcul 3 + 5 » 
qui seront traduites par le programme de « traduction » en quelque chose comme : 
« 0010110110010011010011110 ». 

Le schema 1.2 resume ce que je viens de vous expliquer. 




1. J'invente, je ne connais quand meme pas la traduction informatique par cceur. 



CHAPITRE 1. VOUS AVEZ BIT PROGRAMMER ? 



Votre programme est ecrit. 
dans un langage simplifie : 



« Fais le calcul 3 + 5" 




Or oMient un programme en 

binaire que votre ordinaleur 

comprend : 

001100110011101001010 



Figure 1.2 - Schema (tres simplifie) de realisation d'un programme 

Un peu de vocabulaire 

La j'ai parle avec des mots simples, mais il faut savoir qu'en informatique il existe 
un mot pour chacune de ces choses-la. Tout au long de ce cours, vous allez d'ailleurs 
apprendre a utiliser un vocabulaire approprie. Non seulement vous aurez l'air de savoir 
de quoi vous parlez, mais si un jour (et ga arrivera) vous devez parler a un autre 
programmeur, vous saurez vous faire comprendre 2 . 

Reprenons le schema que l'on vient de voir. La premiere case est « Votre programme 
est ecrit dans un langage simplifie ». Ce fameux « langage simplifie » est appele en fait 
langage de haut niveau. II existe plusieurs niveaux de langages. Plus un langage est 
haut niveau, plus il est proche de votre vraie langue (comme le frangais). Un langage de 
haut niveau est done facile a utiliser, mais cela a aussi quelques petits defauts comme 
nous le verrons plus tard. 

II existe de nombreux langages de plus ou moins haut niveau en informatique dans 
lesquels vous pouvez ecrire vos programmes. En voici quelques-uns par exemple : 

- leC; 

- le C++ ; 

- Java ; 

- Visual Basic ; 

- Delphi ; 

- etc. 

Notez que je ne les ai pas classes par « niveau de langage », n'allez done pas vous 
imaginer que le premier de la liste est plus facile que le dernier ou l'inverse. Ce sont 
juste quelques exemples 3 . 

Certains de ces langages sont plus haut niveau que d'autres (done en theorie un peu 
plus faciles a utiliser). On va voir notamment un peu plus loin ce qui differencie le 
langage C du langage C++. 

Un autre mot de vocabulaire a retenir est code source. Ce qu'on appelle le code 
source, e'est tout simplement le code de votre programme ecrit dans un langage de 
haut niveau. C'est done vous qui ecrivez le code source, qui sera ensuite traduit en 



2. Certes, les gens autour de vous vous regarderont comme si vous etiez des extra-terrestres, mais 
ga il ne faudra pas y faire attention ! 

3. D'avance desole pour tous les autres langages qui existent, mais faire une liste complete serait 
vraiment trop long ! 



PROGRAMMER, DANS QUEL LANG AGE \ 



binaire. 

Venons-en justement au « programme de traduction » qui traduit notre langage de haut 
niveau (comme le C ou le CH — Y) en binaire. Ce programme a un nom : on l'appelle le 
compilateur. La traduction, elle, s'appelle la compilation. 

Tres important : il existe un compilateur different pour chaque langage de haut niveau. 
C'est d'ailleurs tout a fait logique : les langages etant differents, on ne traduit pas le 
C++ de la meme maniere qu'on traduit le Delphi. 
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Vous verrez par la suite que meme pour le langage C il existe plusieurs com- 
pilateurs differents I II y a le compilateur ecrit par Microsoft, le compilateur 
GNU, etc. On verra tout cela dans le chapitre suivant. Heureusement, ces 
compilateurs-la sont quasiment identiques (meme s'il y a parfois quelques 
« legeres » differences que nous apprendrons a reconnaTtre). 



Enfin, le programme binaire cree par le compilateur est appele l'executable. C'est 
d'ailleurs pour cette raison que les programmes (tout du moins sous Windows) ont 
l'extension « .exe » comme EXEcutable. 

Reprenons notre schema precedent, et utilisons cette fois des vrais mots tordus d'in- 
formaticien (fig. 1.3). 



Votre programme est ecrit 

dans un langege de haut 

niveau ■ 

c Fals Is calcul 3 + 5 » 




Compilateur 



Executable (programrne.exe 
sous Windows} : 



001 1001 1001 1101001 DID 



Figure 1.3 - Le meme schema, avec le bon vocabulaire 



Pourquoi choisir d'apprendre le C ? 



Comme je vous l'ai dit plus haut, il existe de tres nombreux langages de haut niveau. 
Doit-on commencer par l'un d'entre eux en particulier ? Grande question. 

Pourtant, il faut bien faire un choix, commencer la programmation a un moment ou a 
un autre. Et la, vous avez en fait le choix entre : 

- un langage tres haut niveau : c'est facile a utiliser, plutot « grand public ». Parmi 
eux, on compte Python, Ruby, Visual Basic et bien d'autres. Ces langages permettent 
d'ecrire des programmes plus rapidement, en regie generale. lis necessitent toutefois 
d'etre accompagnes de fichiers pour qu'ils puissent s'executer (comme un interpre- 
teur) ; 

- un langage un peu plus bas niveau (mais pas trop quand meme!) : ils sont 
peut-etre un peu plus difficiles certes, mais avec un langage comme le C, vous allez 
en apprendre beaucoup plus sur la programmation et sur le fonctionnement de votre 



CHAPITRE 1. VOUS AVEZ BIT PROGRAMMER ? 




ordinateur. Vous serez ensuite largement capables d'apprendre un autre langage de 
programmation si vous le desirez. Vous serez done plus autonomes. Par ailleurs, le C 
est un langage tres populaire. II est utilise pour programmer une grande partie des 
logiciels que vous connaissez. 

Enfin, le langage C est un des langages les plus connus et les plus utilises qui existent. 
II est tres frequent qu'il soit enseigne lors d'etudes superieures en informatique. 

Voila les raisons qui m'incitent a vous apprendre le langage C plutot qu'un autre 4 . Je 
ne dis pas qu'il faut commencer par ga, mais je vous dis plutot que e'est un bon choix 
qui va vous donner de solides connaissances. 

Je vais supposer tout au long de ce cours que e'est votre premier langage de program- 
mation, que vous n'avez jamais fait de programmation avant. Si par hasard, vous avez 
deja un peu programme, ca ne pourra pas vous faire de mal de reprendre a zero. 

II y a quelque chose que je ne comprends pas. . . Quelle est la difference entre 
J le langage « C » et cet autre langage dont on parle, le langage « C++ » ? 

Le langage C et le langage C++ sont tres similaires. lis sont tous les deux toujours tres 
utilises. Pour bien comprendre comment ils sont nes, il faut faire un peu d'histoire. 

- Au tout debut, a l'epoque ou les ordinateurs pesaient des tonnes et faisaient la taille 
de votre maison, on a commence a inventer un langage de programmation appele 
l'Algol. 

- Les choses evoluant, on a cree un nouveau langage appele le CPL, qui evolua lui- 
meme en BCPL, qui prit ensuite le nom de langage B. 

- Puis un beau jour, on en est arrive a creer un autre langage encore, qu'on a appele. . . 
le langage C. Ce langage, s'il a subi quelques modifications, reste encore un des plus 
utilises aujourd'hui. 

- Un peu plus tard, on a propose d'ajouter des choses au langage C. Une sorte d'amelio- 
ration si vous voulez. Ce nouveau langage, que l'on a appele « C++ », est entierement 
base sur le C. Le langage C-| — |- n'est en fait rien d'autre que le langage C avec des 
ajouts permettant de programmer d'une facon differente. 

Qu'il n'y ait pas de malentendus : le langage C++ n'est pas « meilleur » 
que le langage C, il permet juste de programmer differemment. Disons aussi 
qu'il permet au final de programmer un peu plus efficacement et de mieux 
hierarchiser le code de son programme. Malgre tout, il ressemble beaucoup 
au C. Si vous voulez passer au C++ par la suite, cela vous sera facile. 
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Ce n'est PAS parce que le C++ est une « evolution » du C qu'il faut absolument faire 
du C++ pour realiser des programmes. Le langage C n'est pas un « vieux langage 
oublie » : au contraire, il est encore tres utilise aujourd'hui. II est a la base des plus 
grands systemes d'exploitation tels Unix (et done Linux et Mac OS) ou Windows. 



4. On pourrait citer d'autres raisons : certains langages de programmation sont plus destines au 
Web (comme PHP) qu'a la realisation de programmes informatiques. 



PROGRAMMER, C'EST DUR? 



Retenez done : le C et le C++ ne sont pas des langages concurrents, on peut faire 
autant de choses avec l'un qu'avec l'autre. Ce sont juste deux manieres de programmer 
assez differentes. 



Programmer, e'est dur ? 

Voila une question qui doit bien vous torturer l'esprit. Alors : faut-il etre un super- 
mathematicien qui a fait 10 ans d'etudes superieures pour pouvoir commencer la pro- 
grammation ? 

La reponse, que je vous rassure, est non. Non, un super-niveau en maths n'est pas ne- 
cessaire. En fait tout ce que vous avez besoin de connaitre, ce sont les quatre operations 
de base : 

- l'addition ; 

- la soustraction ; 

- la multiplication ; 

- la division. 

Ce n'est pas trop intimidant, avouez ! Je vous expliquerai dans un prochain chapitre 
comment l'ordinateur realise ces operations de base dans vos programmes. 

Bref, niveau maths, il n'y a pas de difficulte insurmontable. En fait, tout depend du 
programme que vous allez realiser : si vous devez faire un logiciel de cryptage, alors 
oui, il vous faudra connaitre des choses en maths. Si vous devez faire un programme 
qui fait de la 3D, oui, il vous faudra quelques connaissances en geometrie de l'espace. 

Chaque cas est particulier. Mais pour apprendre le langage C lui-meme, vous n'avez 
pas besoin de connaissances pointues en quoi que ce soit. 




<? 



Mais alors, ou est le piege? Ou est la difficulte? 



II faut savoir comment un ordinateur fonctionne pour comprendre ce qu'on fait en C. 
De ce point de vue-la, rassurez-vous, je vous apprendrai tout au fur et a mesure. 

Notez qu'un programmeur a aussi certaines qualites comme : 

- la patience : un programme ne marche jamais du premier coup, il faut savoir per- 
severer ! 

- le sens de la logique : pas besoin d'etre forts en maths certes, mais ca ne vous 
empechera pas d'avoir a reflechir. Desole pour ceux qui pensaient que qa allait tomber 
tout cuit sans effort ! 

- le calme : non, on ne tape pas sur son ordinateur avec un marteau. Ce n'est pas ca 
qui fera marcher votre programme. 

En bref, et pour faire simple, il n'y a pas de veritables connaissances requises pour 
programmer. Un nul en maths peut s'en sortir sans probleme, le tout est d'avoir la 
patience de reflechir. II y en a d'ailleurs beaucoup qui decouvrent qu'ils adorent qa ! 



CHAPITRE 1. VOUS AVEZ DIT PROGRAMMER ? 



En resume 

- Pour realiser des programmes informatiques, on doit ecrire dans un langage que 
l'ordinateur « comprend ». 

- II existe de nombreux langages informatiques que l'on peut classer par niveau. Les 
langages dits de « haut niveau » sont parfois plus faciles a maitriser au detriment 
souvent d'une perte de performances dans le programme final. 

- Le langage C que nous allons etudier dans ce livre est considere comme etant de bas 
niveau. C'est un des langages de programmation les plus celebres et les plus utilises 
au monde. 

- Le code source est une serie d'instructions ecrites dans un langage informatique. 

- Le compilateur est un programme qui transforme votre code source en code bi- 
naire, qui peut alors etre execute par votre processeur. Les . exe que l'on connait 
sont des programmes binaires, il n'y a plus de code source a l'interieur. 

- La programmation ne requiert pas en elle-meme de connaissances mathematiques 
poussees 5 ; neanmoins, il est necessaire d'avoir un bon sens de la logique et d'etre 
methodique. 



5. Sauf dans quelques cas precis ou votre application doit faire appel a des formules mathematiques, 
comme c'est le cas des logiciels de cryptage. 
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Chapitre 



2 



Ayez les bons outils ! 



Difficulty : MH 

Apres un premier chapitre plutot introductif, nous commencons a entrer dans le vif du 
sujet. Nous allons repondre a la question suivante : « De quels logiciels a-t-on besoin 
pour programmer? ». 

II n'y aura rien de difficile a faire dans ce chapitre, on va prendre le temps de se familiariser 
avec de nouveaux logiciels. 

Profitez-en ! Dans le chapitre suivant, nous commencerons a vraiment programmer et il ne 
sera plus I'heure de faire la sieste I 



i 
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CHAPITRE 2. AYEZ LES BONS OUTILS ! 



Les outils necessaires au programmeur 

Alors a votre avis, de quels outils un programmeur a-t-il besom? Si vous avez attenti- 
vement suivi le chapitre precedent, vous devez en connaitre au moins un ! 

Vous voyez de quoi je parle ?. . . Vraiment pas ? 

Eh oui, il s'agit du compilateur, ce fameux programme qui permet de traduire votre 
langage C en langage binaire ! 

Comme je vous l'avais deja un peu dit dans le premier chapitre, il existe plusieurs 
compilateurs pour le langage C. Nous allons voir que le choix du compilateur ne sera 
pas tres complique dans notre cas. 

Bon, de quoi d'autre a-t-on besoin ? Je ne vais pas vous laisser deviner plus longtemps. 
Voici le strict minimum pour un programmeur : 

- un editeur de texte pour ecrire le code source du programme. En theorie un logiciel 
comme le Bloc-notes sous Windows, ou « vi » sous Linux fait l'affaire. L'ideal, c'est 
d'avoir un editeur de texte intelligent qui colore tout seul le code, ce qui vous permet 
de vous y reperer bien plus facilement ; 

- un compilateur pour transformer (« compiler ») votre source en binaire; 

- un debogueur pour vous aider a traquer les erreurs dans votre programme 1 . 

A priori, si vous etes aventuriers, vous pouvez vous passer de debogueur. Mais bon, je 
sais pertinemment que vous ne tarderez pas a en avoir besoin. ;-) 

A partir de maintenant on a deux possibilites : 

- soit on recupere chacun de ces trois programmes separement. C'est la methode 
la plus compliquee, mais elle fonctionne. Sous Linux en particulier, bon nombre de 
programmeurs preferent utiliser ces trois programmes separement. Je ne detaillerai 
pas cette methode ici, je vais plutot vous parler de la methode simple ; 

- soit on utilise un programme « trois-en-un » (comme les liquides vaisselle, oui, oui) 
qui combine editeur de texte, compilateur et debogueur. Ces programmes « trois-en- 
un » sont appeles IDE 2 , ou encore « Environnements de developpement ». 

II existe plusieurs environnements de developpement. Au debut, vous aurez peut-etre 
un peu de mal a choisir celui qui vous plait. Une chose est sure en tout cas : vous pouvez 
realiser n'importe quel type de programme, quel que soit l'IDE que vous choisissez. 

Choisissez votre IDE 

II m'a semble interessant de vous montrer quelques IDE parmi les plus connus. Tous 
sont disponibles gratuitement. Personnellement, je navigue un peu entre tous ceux-la 
et j 'utilise l'IDE qui me plait selon le jour. 

- Un des IDE que je prefere s'appelle Code: :Blocks. II est gratuit et fonctionne sur 
la plupart des systemes d'exploitation. Je conseille d'utiliser celui-ci pour debuter (et 



1. On n'a malheureusement pas encore invente le « correcteur » qui corrigerait tout seul nos erreurs. 
Ceci dit, quand on sait bien se servir du debogueur, on peut facilement retrouver ses erreurs! 

2. Integrated Development Environment 
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CODE: .BLOCKS (WINDOWS, MAC OS, LINUX) 



meme pour la suite s'il vous plait bien !). Fonctionne sous Windows, Mac et Linux. 
Le plus celebre IDE sous Windows, c'est celui de Microsoft : Visual C-| — \-. II existe a 
la base en version payante (chere!), mais il existe heureusement une version gratuite 
intitulee Visual C-| — |- Express qui est vraiment tres bien (il y a peu de diffe- 
rences avec la version payante). II est tres complet et possede un puissant module de 
correction des erreurs (debogage). Fonctionne sous Windows uniquement. 
Sur Mac OS X, vous pouvez utiliser Xcode, generalement fourni sur le CD d'ins- 
tallation de Mac OS X. C'est un IDE tres apprecie par tous ceux qui font de la 
programmation sur Mac. Fonctionne sous Mac OS X uniquement. 

Note pour les utilisateurs de Linux : il existe de nombreux IDE sous Linux, mais 
les programmeurs experimentes preferent parfois se passer d'IDE et compiler 
« a la main », ce qui est un peu plus difficile. En ce qui nous concerne nous al- 
lons commencer par utiliser un IDE. Je vous conseille d'installer Code: :Blocks 
si vous etes sous Linux, pour suivre mes explications. 




a 
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Quel est le meilleur de tous ces IDE? 



Tous ces IDE vous permettront de programmer et de suivre le reste de ce cours sans 
probleme. Certains sont plus complets au niveau des options, d'autres un peu plus 
intuitifs a utiliser, mais dans tous les cas les programmes que vous creerez seront les 
memes quel que soit FIDE que vous utilisez. Ce choix n'est done pas si crucial qu'on 
pourrait le croire. 

Tout au long de tout ce cours, j'utiliserai Code: :Blocks. Si vous voulez obtenir exac- 
tement les memes ecrans que moi, surtout pour ne pas etre perdus au debut, je vous 
recommande done de commencer par installer Code: :Blocks. 



Code: :Blocks (Windows, Mac OS, Linux) 



Code: :Blocks est un IDE libre et gratuit, disponible pour Windows, Mac et Linux. 

Code: :Blocks n'est disponible pour le moment qu'en anglais. Cela ne devrait PAS vous 
repousser a Futiliser. Croyez-moi, nous aurons quoi qu'il en soit peu affaire aux menus : 
c'est le langage C qui nous interesse. 

Sachez toutefois que quand vous programmerez, vous serez de toute fagon confrontes 
bien sou vent a des documentations en anglais. Voila done une raison de plus pour 
s'entrainer a utiliser cette langue. 
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CHAPITRE 2. AYEZ LES BONS OUTILS ! 



Telecharger Code: :Blocks 

Rendez-vous sur la page de telechargements de Code: :Blocks ' 



> ( Code web : 870337 ) 

- Si vous etes sous Windows, reperez la section « Windows » un peu plus bas sur cette 
page. Telechargez le logiciel en prenant le programme qui contient mingw dans le nom 
(ex. : codeblocks-8.02mingw-setup.exe). L'autre version etant sans compilateur, 
vous auriez eu du mal a compiler vos programmes ! 

- Si vous etes sous Linux, choisissez le package qui correspond a votre distribution. 

- Enfin, sous Mac, choisissez le fichier le plus recent de la liste. 
Ex. : codeblocks-8.02-p2-mac.zip. 

^installation est tres simple et rapide. Laissez toutes les options par defaut et lancez 
le programme. Vous devriez voir une fenetre similaire a la fig. 2.1. 

On distingue 4 grandes sections dans la fenetre, numerotees sur l'image : 

1. la barre d'outils : elle comprend de nombreux boutons, mais seuls quelques-uns 
nous seront regulierement utiles. J'y reviendrai plus loin ; 

2. la liste des fichiers du projet : c'est a gauche que s'affiche la liste de tous 
les fichiers source de votre programme. Notez que sur cette capture aucun projet 
n'a ete cree, on ne voit done pas encore de fichiers a l'interieur de la liste. Vous 
verrez cette section se remplir dans cinq minutes en lisant la suite du cours ; 

3. la zone principale : c'est la que vous pourrez ecrire votre code en langage C ; 

4. la zone de notification : aussi appelee la « zone de la mort », c'est ici que vous 
verrez les erreurs de compilation s'afficher si votre code comporte des erreurs. 
Cela arrive tres regulierement ! 

Interessons-nous maintenant a une section particuliere de la barre d'outils (fig. 2.2). 
Vous trouverez les boutons suivants (dans l'ordre) : Compiler, Executer, Compiler & 
Executer et Tout recompiler. Retenez-les, nous les utiliserons regulierement. 

Voici la signification de chacune des quatre icones que vous voyez sur la fig. 2.2, dans 
l'ordre : 

- compiler : tous les fichiers source de votre projet sont envoyes au compilateur qui 
va se charger de creer un executable. S'il y a des erreurs 4 , l'executable ne sera pas 
cree et on vous indiquera les erreurs en bas de Code: :Blocks ; 

- executer : cette icone lance juste le dernier executable que vous avez compile. Cela 
vous permettra done de tester votre programme et de voir ainsi ce qu'il donne. Dans 
l'ordre, si vous avez bien suivi, on doit d'abord compiler, puis executer pour tester 
ce que ga donne. On peut aussi utiliser le troisieme bouton. . . 

- compiler & executer : pas besoin d'etre un genie pour comprendre que c'est 
la combinaison des deux boutons precedents. C'est d'ailleurs ce bouton que vous 



3. J'en profite pour vous rappeler que les codes web peuvent etre entres dans le formulaire du 
Site du Zero prevu a cet effet. Cela vous redirige automatiquement sur la page ou le fichier qui vous 
interesse. Voir l'avant-propos pour plus d'informations a ce sujet. 

4. Ce qui a de fortes chances d'arriver t6t ou tard ! 
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CODE: .BLOCKS (WINDOWS, MAC OS, LINUX) 



■ Bhs- r 



Hi Start here - Code::B[ocks 3.02 



File Edit View Search Project Build Debug wxSrnith Tools Pjugins Settings Help 

: J l£H0l*>l<( fcl9>&| 



(D 



H>i??^. ?}{?©!□ ).!«» Q SQ | Build target: 



Management 



Projects Symbols 

-Ql Workspace 



(2) 



X 



J Start here X 



(3) 




Code:: Blocks 

The open source, cross-platform IDE 
hfip:/Arww.codeb/ocks. org 

I U_ I 



Release B.C2i2:CE-:2-2~ li:-:;:!: ;c; - 1 1 ■ , ■ -sc.vs/unicode 



^ 



Create a new project 



Open an existing project 



O 



Recent projects 

• C:\UsersV '*it z -z i:i~z^~z*l.cbc 

• C:\U5ers\M ate c'.Pr: : v Z? ■ -: ZStringcbp 

• C:\Use rs'.' jafcajPra e^'.ccurs ccc'.heritace.cbc 

Recent files 



' 



Messages 



Code::Elocks | ^ Search results | ^ Build log | # Build messages Cj Debugger 



X 



Line Message 



(4) 



' 



Figure 2.1 - Code: :Blocks 



O»O0 



Figure 2.2 - Les principaux boutons de la barre d'outils 
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CHAPITRE 2. AYEZ LES BONS OUTILS ! 



utiliserez le plus souvent. Notez que s'il y a des erreurs pendant la compilation 
(pendant la generation de l'executable), le programme ne sera pas execute. A la 
place, vous aurez droit a une beeelle liste d'erreurs a corriger ! 

tout reconstruire : quand vous faites compiler, Code: :Blocks ne recompile en fait 
que les fichiers que vous avez modifies et non les autres. Parfois - je dis bien parfois - 
vous aurez besoin de demander a Code: :Blocks de vous recompiler tous les fichiers. 
On verra plus tard quand on a besoin de ce bouton, et vous verrez plus en details 
le fonctionnement de la compilation dans un chapitre futur. Pour l'instant, on se 
contente de savoir le minimum necessaire pour ne pas tout melanger. Ce bouton ne 
nous sera done pas utile de suite. 




a 



Je vous conseille d'utiliser les raccourcis plutot que de cliquer sur les boutons, 
parce que e'est quelque chose qu'on fait vraiment tres tres souvent. Retenez 
en particulier qu'il faut taper sur F9 pour faire Compiler & Executer. 



Creer un nouveau projet 

Pour creer un nouveau projet, e'est tres simple : allez dans le menu File / New / 
Project. Dans la fenetre qui s'ouvre (fig. 2.3), choisissez Console application. 



"EMU 



New from template 



Projects 

Build targets 

Files 

Custom 

User templates 


Category: | <All categories > 


-1 






AVR Project 


Code:: Blocks 
plugin 


m i 




m 


o 


m 




D application 


Direct/X project 


Dynamic Link 
Library 




□ 


'fltk 


GLFfl 




Empty project 


FLTK project 


GLFW project 




GLUT 


* 


jj-ICMf 




GLUT project 


GTK+ project 


Irrlicht project 



TIP: Try right-dicking an item 



View as 

a Large icons 

O List 



1. Select a wizard type first on the left 

Z. Select a specific wizard from the main window [filter by categories if needed) 

3. Press Go 



Figure 2.3 - Nouveau projet 
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CODE: -.BLOCKS (WINDOWS, MAC OS, LINUX) 




O 



Comme vous pouvez le voir, Code: :Blocks propose de realiser pas mal de types 
de programmes differents qui utilisent des bibliotheques connues comme la 
SDL (2D), OpenGL (3D), Qt et wxWidgets (fenetres), etc. Pour I'instant, 
ces icones servent plutot a faire joli car les bibliotheques ne sont pas installees 
sur votre ordinateur, vous ne pourrez done pas les faire marcher. Nous nous 
interesserons a ces autres types de programmes bien plus tard. En attendant 
il faudra vous contenter de « Console », car vous n'avez pas encore le niveau 
necessaire pour creer les autres types de programmes. 



Cliquez sur Go pour creer le projet. Un assistant s'ouvre. Faites Next, cette premiere 
page ne servant a rien. 

On vous demande ensuite si vous allez faire du C ou du C++ (fig. 2.4) : repondez 
« C ». 



Console application 



TEJ 




Please select the language you want to use. 
Please make a selection 




< Back Next > Cancel 



Figure 2.4 - Choix du langage 

On vous demande le nom de votre projet (fig. 2.5) et dans quel dossier les fichiers 
source seront enregistres. 

Enfin, la derniere page (fig. 2.6) vous permet de choisir de quelle facon le programme 
doit etre compile. Vous pouvez laisser les options par defaut, ca n'aura pas d'incidence 
sur ce que nous allons faire dans l'immediat (veillez a ce que la case Debug ou Release 
au moins soit cochee). 

Cliquez sur Finish, e'est bon ! Code: :Blocks vous creera un premier projet avec deja 
un tout petit peu de code source dedans. 

Dans le cadre de gauche « Projects », developpez l'arborescence en cliquant sur le petit 
« + » pour afficher la liste des fichiers du projet. Vous devriez avoir au moins un main, c 
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"E^n 



Console application 




Please select the folder where you want the new project 
to be created as well as its title. 



Project title: 



monprogramme 

Folder to create project in: 



Q 



C : \Users V^lateo ^rojets \ 

Project filename: 
monprogramme. cbp 



Resulting filename: 

C : \Users V^ateo ^rojeta Vnonprogramme Vnonprogramme 



<Back Next> Cancel 



Figure 2.5 - Nom et emplacement du projet 



tkd 



Console application 




Please select the compiler to use and which configurations 
you want enabled in your project. 



Compiler: 



*■:' . ::c co-o s- 



Create 'Release 1 ' configuration: Release 
"Release r options 
Output dir . : binV^elease \ 



Objects output dir. : objV^elease\ 



Create "Debug 1- configuration: Debug 






Output dir.: 


bin£>ebug\ 






Objects output dir. 


obj£>ebug\ 



Figure 2.6 - Mode de compilation 
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que vous pourrez ouvrir en double-cliquant dessus. Vous voila pares ! 



Visual C-\ — h (Windows seulement) 

Quelques petits rappels sur Visual C++ : 

- c'est TIDE de Microsoft ; 

- il est a la base payant, mais Microsoft a sorti une version gratuite intitulee Visual 
C++ Express ; 

- il permet de programmer en C et en CH — h (et non pas seulement en CH — h comme 
son nom le laisse entendre). 

Nous allons bien entendu voir ici la version gratuite, Visual C++ Express 5 (fig. 2.7). 



dQ Page de demarrage - Visual C++ 2008 Express (Administrates} 



I D=) 



Fichier Edition Affichage Outils Fenetre ? 



\\3 



orateur de solutions t fl- X 



c-^ Exp I or... |EjAffich... I^Gestio.. 



Page de demurrage I 




Visual C++' 2008 

Express 



' 



ha 



md 



TeEecharger les informations des pfus rec 
Cliquez ici pour activer un flux RSS qui fou 
article: mis a jour sur les nouvellestechnol 
des astuces sur le produit et des even em er 



H 



af 



n 



Fenetre Definition de code 

Aucune definition selectionnee 



c 



-r * X 



_^ Fenetre Definition de code I^HExplorateur d'appels |[=] Sortie I 



Figure 2.7 - Visual C++ Express 




Quelles sont les differences avec le « vrai » Visual? 



5. Attention, il n'est compatible avec Windows 7 qu'a partir de la version 2010. 
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II n'y a pas l'editeur de ressources qui vous permet de dessiner des images, des icones, 
ou des fenetres. Mais bon, <ja, entre nous, on s'en moque bien parce qu'on n'aura pas 
besoin de s'en servir dans ce cours. Ce ne sont pas des fonctionnalites indispensables, 
bien au contraire. 

Pour telecharger Visual C++ Express, rendez-vous sur le site web de Visual C++. 



> [ Code web : 333733 ) 

Selectionnez ensuite Visual C++ Express Frangais un peu plus bas sur la page. 

Visual C++ Express est en frangais et totalement gratuit. Ce n'est done pas une version 
d'essai limitee dans le temps. C'est une chance d'avoir un IDE aussi puissant que celui 
de Microsoft disponible gratuitement, ne la laissez done pas passer. 

Installation 

L'installation devrait normalement se passer sans encombre. Le programme d'instal- 
lation va telecharger la derniere version de Visual sur Internet. Je vous conseille de 
laisser les options par defaut. 

A la fin, on vous dit qu'il faut vous enregistrer dans les 30 jours. Pas de panique, c'est 
gratuit et rapide mais il faut le faire. 

Cliquez sur le lien qui vous est donne : vous arrivez sur le site de Microsoft. Connectez- 
vous avec votre compte Windows Live ID (equivalent du compte Hotmail ou MSN) ou 
creez-en un si vous n'en avez pas, puis repondez au petit questionnaire. 

On vous donnera a la fin une cle d'enregistrement. Vous devrez recopier cette cle dans 
le menu ? / Inscrire le produit. 

Creer un nouveau projet 

Pour creer un nouveau projet sous Visual, allez dans le menu Fichier / Nouveau / 
Projet. Selectionnez Win32 dans la colonne de gauche, puis Application console 
Win32 a droite (fig. 2.8). Entrez un nom pour votre projet, par exemple test. 

Validez. Une nouvelle fenetre s'ouvre (fig. 2.9). Cette fenetre ne sert pas a grand-chose. 
Par contre, cliquez sur Parametres de 1' application dans la colonne de gauche. 

Veillez a ce que Projet vide soit coche comme sur la fig. 2.10. Cliquez enfin sur 
Terminer. 

Ajouter un nouveau fichier source 

Votre projet est pour l'instant bien vide. Faites un clic droit sur le dossier Fichiers 
source situe sur votre gauche, puis allez dans Ajouter / Nouvel element (fig. 2.11). 

Une fenetre s'ouvre. Selectionnez Fichier C++ (.cpp) 6 . Entrez un nom pour votre 



6. Je sais, on ne fait pas de C++ mais ca n'a pas d'importance ici. 
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V I' % - II 



Nouveau projet 



Types de projets : 



Modeler : 



ra@ 



Visual C++ 
CLR 
Win32 

3 c -; r 



Modeles Visual Studio installed 
.^Application consoleWin32 
Mes modeles 



H Projet Win32 



,eJP Rec here her des modeles en ligne... 



Projet de creation d'une application console Win32 
Norn : 



test] 



Emplacement : C:\Users\Mateo\Documents\Visual Studio 2008\P rejects 



Nom de solution : test 



[71 Creer le repertoire pour la solution 



Figure 2.8 - Creation de projet Visual C++ Express 



Assistant Application Win32 - test 



Li? 



Bien venue dans I 1 Assistant Application Win32 



Vue d'ensemble 
Pararnetres de I'application 



Les pararnetres actuels du projet sont les suivants : 
• Application console 



Cliquez sur Terminer dans n'importe quelle fenetre pour accepter les pararnetres 
actuels. 



Apres avoir tree le projet r consultez son fichier readrne.txt pour vous informer sur 
ses fonctionnalites et sur les fichiers generes. 



I Suivant > I Terminer | Annuler 



Figure 2.9 - Assistant creation de projet Visual C++ Express 
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Assistant Application Win32 - test 



? 



Para metres de 1'appltcation 



Vue d'ensemble 
Parametres de I'application 



Type d'application : 

Application Windows 
(ft) Application console 

DLL 
Q Bibliotheque statique 
Options supplementaires : 



prgjetyidej 
I I Exporter des symboles 
En-tete p_recompile 



Ajouter les fichiers d'en-tete courants 
pour : 

□ atl 
Dmfc 



in^nTi 



Figure 2.10 - Configuration du projet 



J^3 Solution 'test' (1 projet] 
■ B test 

LJ Fichiers d'en-tete 
L^ J Fichiers de resources 

car - 



STjExplor... p 



-enetre Defini 
Aucune 



Ajouter 



Couper 

Copier 

Coller 

Supprimer 

Renommer 



Proprietes 



ER- 



s n 



y 



Vi: 

Exp 



^| Nouvel element 

m 



ElUtfient exists nt.. 
No uvea u Filtre 



Classe... 



ctionnee 



Figure 2.11 - Ajout d'un fichier source 
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fichier : main.c, comme sur la fig. 2.12. 



Ajouter un nouvel element - test 



Categories : 



Modeles : 



03 in 



Visual C+ + 
UI 

Code 
Feuilles de propriety 



Modeled Visual Studio installer 
[^Windows Form 
[rf] Fichier d' en -tete (.h) 
eft] Classe Component 

Mes modeled 



[^ Fichier C++ (.cpp] 

.=^1 Feuille de propriety (.vsprops) 



-jj| Rechercher des modeled en ligne... 



Cree un fichier contenant du codesourceC+ + 
Norn : main.c 

Emplacement : 



c:\Users\Mateo\Documents\Visual Studio 2008\Projects\test\test 



Ajouter Annuler 



Figure 2.12 - Choix du type et du nom du fichier source 
Cliquez sur Ajouter. C'est bon, vous allez pouvoir commencer a ecrire du code! 

La fenetre principale de Visual 

Voyons ensemble le contenu de la fenetre principale de Visual C++ Express (fig. 2.13). 

Cette fenetre ressemble en tous points a celle de Code: :Blocks. On va rapidement 
(re)voir quand meme ce que signifient chacune des parties. 

1. La barre d'outils : tout ce qu'il y a de plus standard. Ouvrir, enregistrer, enre- 
gistrer tout, couper, copier, coller, etc. Par defaut, il semble qu'il n'y ait pas de 
bouton de barre d'outils pour compiler. Vous pouvez les rajouter en faisant un clic 
droit sur la barre d'outils, puis en choisissant Deboguer et Generer dans la liste. 
Toutes ces icfines de compilation ont leur equivalent dans les menus Generer et 
Deboguer. Si vous faites Generer, cela creera l'executable (<ja signifie « compiler » 
pour Visual). Si vous faites Deboguer / Executer, on devrait vous proposer de 
compiler avant d'executer le programme. F7 permet de generer le projet, et F5 
de l'executer. 

2. Dans cette zone tres importante vous voyez normalement la liste des fichiers de 
votre projet. Cliquez sur l'onglet Explorateur de solutions en bas, si ce n'est 
deja fait. Vous devriez voir que Visual cree deja des dossiers pour separer les 
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i^ test - Visual C++ 2QQ& Express (Administrateur) 



Fichier Edition Affichage Projet Generer Deboguer Outils Fenetre 



h % ^, ** l * * ri 1 1 □ 



. | k Debug - Win32 

- 46 3- ; (1) 



Explorateur de solutions -... t fl- X 



_^5 Solution 'test' (1 projet] 
■ B test 

i J Fichiers d'en-tete 
LJl Fichiers de ressou re es 
B- & Fichiers sources 
tjj rnain.c 

(2) 



dJJExplor... p|Affich... [.JGestio... | \j_[ 



Page de demarrage 




Fenetre Definition de code 

Aucune definition selectionnee 



(4) 



C 



-r f X 



^2 Fenetre Definition de code ^U Explorateur d'appels [=] Sortie 



Coll Carl 



Figure 2.13 - Fenetre principale de Visual C++ Express 
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differents types de fichiers de votre projet (sources, en-tete et ressources). Nous 
verrons un peu plus tard quels sont les differents types de fichiers qui constituent 
un projet. 

3. La partie principale. C'est la qu'on modifie les fichiers source. 

4. C'est la encore la « zone de la mort », celle ou on voit apparaitre toutes les 
erreurs de compilation. C'est dans le bas de l'ecran aussi que Visual affiche les 
informations de debogage quand vous essayez de corriger un programme bogue. 

Voila, on a fait le tour de Visual C++. Vous pouvez aller jeter un ceil dans les options 
(Outils / Options) si <ja vous chante, mais n'y passez pas trois heures. II faut dire 
qu'il y a tellement de cases a cocher de partout qu'on ne sait plus trop ou donner de 
la tete. 



Xcode (Mac OS seulement) 



II existe plusieurs IDE compatibles Mac. II y a Code: :Blocks bien sur, mais ce n'est 
pas le seul. Je vais vous presenter ici l'IDE le plus celebre sous Mac : Xcode. 

Cette section dediee a Xcode est inspiree d'un tutoriel paru sur LogicielMac.com, avec 
l'aimable autorisation de son auteur PsychoH13. 



> [ Code web : 648584 ) 

Xcode, ou es-tu ? 

Tous les utilisateurs de Mac OS ne sont pas des programmeurs. Apple l'a bien compris et 
n'installe pas par defaut d'IDE avec Mac OS. Heureusement, pour ceux qui voudraient 
programmer, tout est prevu. En effet, Xcode est present sur le CD d'installation de 
Mac OS (logo fig. 2.14). 




Figure 2.14 - Logo de Xcode 

Inserez done le CD dans le lecteur et installez-le. II se trouve dans les « Developer 
Tools ». 

Par ailleurs, je vous conseille de mettre en favoris la page dediee aux developpeurs sur 
le site d'Apple. Vous y trouverez une foule d'informations utiles pour le developpement 
sous Mac. Vous pourrez notamment y telecharger plusieurs logiciels pour developper. 
N'hesitez pas a vous inscrire a l'ADC (« Apple Development Connection »), c'est 
gratuit et vous serez ainsi tenus au courant des nouveautes. 

> ( Code web : 264708 ) 
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Lancement de Xcode 

Lorsque vous lancez Xcode pour la premiere fois, vous serez probablement surpris. Et 
il y a de quoi. Contrairement a la plupart des logiciels Mac, il n'y a pas de fenetre de 
bienvenue. En fait, la premiere fois, on trouve ca un peu vide. . . et pourtant, c'est un 
logiciel tres puissant ! 




a 



Xcode est TIDE le plus utilise sous Mac, cree par Apple lui-meme. Les plus 
grands logiciels, comme iPhoto et Keynote, ont ete codes a I'aide de Xcode. 
C'est reellement I'outil de developpement de choix quand on a un Mac! 



La premiere chose a faire est de creer un nouveau projet, alors commencons par ca. 
Allez dans le menu File / New Project. Une fenetre de selection de projet s'ouvre 
(%■ 2.15). 



Choose a template for your new project: 



l£l- 



hwi- ■:-'.■.■£ rv c. L L'-ary 
Application Plug -In 



Te m pi a le sfa r Xc o de 



A 



**> 



Ui ■ 



J^.'.l.ll.'JII.'fc 



Typ* [jz_ 



3 



M Command Line Toot 




( Cancel | fa 



Figure 2.15 - Accueil de Xcode 

Allez dans la section Application et selectionnez Command Line Tool 7 . 

Cliquez ensuite sur Next. On vous demandera ou vous voulez enregistrer votre projet 
(un projet doit toujours etre enregistre des le debut) ainsi que son nom. Placez-le dans 
le dossier que vous voulez. 



7. Si vous avez une version plus ancienne du logiciel, il vous faudra probablement aller dans la 
section Command line utility et selectionner Standard tool. 
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Une fois cree, votre projet se presentera sous la forme d'un dossier contenant de mul- 
tiples fichiers dans le Finder. Le fichier a l'extension . xcodepro j correspond au fichier 
du projet. C'est lui que vous devrez selectionner la prochaine fois si vous souhaitez 
reouvrir votre projet. 

La fenetre de developpement 

Dans Xcode, si vous selectionnez main.c, vous devriez avoir une fenetre similaire a la 
fig. 2.16. 



6O0 [c] main.c - Mon_Premier_Programine 



-'■■ i 



Page 



Active Target Action Clean All Build Build and Go 



(1)^ ° 

^ J fi Qs Regular Expressi; 

Info Editor Search 



Croups & Files 

► :_! Mon_Premier_Prograi B 

► ((^Targets 
►■\^ Executables 
►^Errors and Warning; 
►■Q^Find Results 

► LJ] Bookmarks 

► J SCM 

V Project Symbols 
►-£_# Implementation Fil< 
»l£ - NIB Files 
►■ i Breakpoints 



I Detail j Project Find 5CM Results 



1 ^ 1 Code 



p; 



Mo n_P r emi e r_P r o g r amme 

Mon_Premier_Programme . 1 



(3) 



< j > i B main.c:!:] 



<No selected symbol > 



^.i-.IHl*. 



#include <stdio . h> 

int main (int argc, const char * argv[ ] ) { 

// insert code here... 

printf{ "Hello, World!\n H ); 

return 0; 
> 



(4) 



Figure 2.16 - Xcode en action 

La fenetre est decoupee en quatre parties, ici numerotees de 1 a 4. 

1. La premiere partie est la barre de boutons tout en haut. Vous pouvez la configurer 
comme bon vous semble, changer les boutons, etc. Les plus importants d'entre 
eux sont representes sur les fig. 2.17 et 2.18. Les trois premiers boutons vous 
permettent de naviguer entre, dans l'ordre : 

- Project : la ou vous voyez vos fichiers et ou vous les modifiez ; 

- Build : vous y voyez le resultat de la compilation de votre programme, et les 
erreurs s'il y en a eu ; 

- Debug : la fenetre de debogage, ou vous pouvez executer votre programme ligne 
par ligne pour trouver et comprendre ses erreurs. 
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Les deux boutons de la fig. 2.18 signifient : 

- Build : compile votre projet, done cree un executable a partir de vos sources ; 

- Build and Go (le bouton que vous utiliserez le plus souvent) : compile votre 
projet et le lance pour le tester. 

2. La partie de gauche correspond a l'arborescence de votre projet. Certaines sec- 
tions regroupent les erreurs, les avertissements, etc. Xcode vous place automati- 
quement dans la section la plus utile, celle qui porte le nom de votre projet. 

3. La troisieme partie change en fonction de ce que vous avez selectionne dans la 
partie de gauche. Ici, on a la liste des fichiers de notre projet : 

- main, c : e'est le fichier source de votre programme (il peut y en avoir plusieurs 
dans les gros programmes) ; 

- Mon_Premier_ Programme : e'est votre programme une fois compile, done 
l'executable que vous pouvez distribuer. Si le fichier est en rouge, e'est qu'il 
n'existe pas encore (vous n'avez done pas encore compile votre programme, 
mais Xcode le reference quand meme) ; 

- Mon_Premier_ Programme. I : e'est votre programme presente en langage as- 
sembleur, un langage tres proche du processeur. Cela ne nous interessera pas, 
mais si vous voulez prendre peur n'hesitez pas a y jeter un ceil. 

4. Enfin, la quatrieme partie, la plus interessante : e'est celle dans laquelle vous 
pourrez ecrire votre code source en langage C. Par defaut, Xcode met juste un 
petit code d'exemple qui affiche « Hello, world ! » a l'ecran. 

[ m-\ s ~T) 

Page 

Figure 2.17 - La barre d'outils (navigation) 

Build Guild and Co 

Figure 2.18 - La barre d'outils (compilation) 



Lancement du programme 

Pour tester ce premier programme, cliquez sur le bouton Build and Go de la barre 
d'outils. Votre ecran devrait changer et ressembler a la fig. 2.19. 

1. Ce sont les boutons qui permettent de changer de page, comme on l'a vu plus 
tot. Selectionnez Project si vous souhaitez revenir a la fenetre precedente. 

2. C'est la cible, le fichier qui reunit les sources compilees de votre programme. 

3. L'executable de votre application. 

4. Le mode de compilation. II peut etre : 
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e^o 



HE 



(V 



Cr<?up* S FlltJ 

T Snurcr 
*_ nain*e 

▼ LJo^ 'ir.cr, t a t i o n 

_2 Hen_p r aiii a r_.P n 

T, Products 

■ Hon_P c •»! e t_P n 



/Til ti maln.c - Mon_Pr*mier_Programm* /J.) /Jl CD 

Man.Frcmmr . ~n j Mon_PrennJ«r... <j^ [ Debug S| ^^ A Jflt *" 

AtErit T«9«i Adlw Executable .*ciWe &uHd Conflg.gi-Micn Build d«jA Cl**n All Run Debug 

P5 



Build _iton_f^9j 



lUlfioa *t*rt*d *t 2006-11-29 12iJ5:Q* +0100. ] 
HcLIn. World! 



Man_P cemi t r_Prograi 



i has silted with status 0. 



"'» 



fSJ 



^include £s tdio . h> 

int main (int argc, connt char 
ft insert coda hare. - . 
ptintf ( H*lio, wori<u \it" ] * 
return 0} 



m 



.RogriiMM«l>«lii«iiull t . 



OSucctMed 



Figure 2.19 - Lancement du programme sous Xcode 

- Debug : l'executable reste dans Xcode et contient des informations de debogage 
pour vous aider a resoudre vos erreurs eventuelles. C'est ce que vous utiliserez 
lorsque vous developperez votre application ; 

- Release : a n'utiliser qu'a la fin. Xcode genere alors l'application definitive, 
faite pour etre partagee et utilisee par d'autres ordinateurs. 

5. Ces deux boutons vous permettent de demarrer l'application directement (Run) 
ou de la demarrer en mode « Debug » pour executer le programme instruction 
par instruction, afin de resoudre les erreurs. N'utilisez Debug que lorsque vous 
avez des erreurs dans votre programme. 

6. La liste des fichiers de votre projet. 

7. L'editeur du code source, comme tout a l'heure. 

8. La console de Xcode. C'est la que vous verrez votre programme s'executer. 

9. Les boutons Build et Run vous permettent de passer du mode « Compilation » 
au mode « Execution ». En clair, avec le premier vous pouvez voir ce qui s'est 
passe pendant la compilation, tandis que dans le second vous pouvez voir ce que 
votre application a affiche une fois qu'elle a ete demarree. 



Ajouter un nouveau fichier 

Au debut, vous n'aurez qu'un seul fichier source (main. c). Cependant, plus loin dans le 
cours, je vous demanderai de creer de nouveaux fichiers source lorsque nos programmes 
deviendront plus gros. 
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Pour creer un nouveau fichier source sous Xcode, rendez-vous dans le menu File / 
New File. Un assistant vous demande quel type de fichier vous voulez creer. Rendez- 
vous dans la section BSD et selectionnez C File (Fichier C). Vous devriez avoir sous 
les yeux la fig. 2.20. 



^^e 



m 



NewC File 



File Name: 


untitled .c 


1 




@ Also create "untitled.h" 




Location: 


-/test 


I'-j ( Choose... ) 








Add to Project: 


test 


m 



( Cancel j 



Targets: ^ ^ test 



( Previous ,i ( Finish ) 



Figure 2.20 - Ajouter un fichier sous Xcode 

Vous devrez donner un nom a votre nouveau fichier (ce que vous voulez). L'extension, 
elle, doit rester . c. Parfois - nous le verrons plus loin -, il faudra aussi creer des fichiers 
.h (mais on en reparlera). La case a cocher Also create fichier. h est la pour ga. 
Pour le moment, elle ne nous interesse pas. 

Cliquez ensuite sur Finish. C'est fait ! Votre fichier est cree et ajoute a votre projet, 
en plus de main. c. 

Vous etes maintenant prets a programmer sous Mac ! 



En resume 

- Les programmeurs ont besoin de trois outils : un editeur de texte, un compilateur et 
un debogueur. 

- II est possible d'installer ces outils separement, mais il est courant aujourd'hui d'avoir 
un package trois-en-un que l'on appelle IDE, l'environnement de developpement. 

- Code: :Blocks, Visual C++ et Xcode comptent parmi les IDE les plus celebres. 
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Chapitre 



3 



Votre premier programme 



Difficulty : Ml 

On a prepare le terrain jusqu'ici, maintenant il serait bien de commencer a programmer 
un peu, qu'en dites-vous ? C'est justement I'objectif de ce chapitre ! A la fin de celui- 
ci, vous aurez reussi a creer votre premier programme ! 

Bon d'accord, ce programme sera en noir et blanc et ne saura que vous dire bonjour, il 
semblera done completement inutile mais ce sera votre premier; je peux vous assurer que 
vous en serez fiers. 
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Console ou fenetre ? 

Nous avons rapidement parle de la notion de « programme console » et de « pro- 
gramme fenetre » dans le chapitre precedent. Notre IDE nous demandait quel type de 
programme nous voulions creer et je vous avais dit de repondre console. 

II faut savoir qu'en fait il existe deux types de programmes, pas plus : 

- les programmes avec fenetres ; 

- les programmes en console. 



Les programmes en fenetres 

Ce sont les programmes que vous connaissez. La fig. 3.1 est un exemple de programme 
en fenetres que vous connaissez surement. 




Figure 3.1 - Le programme Paint 

Qa done, e'est un programme avec des fenetres. Je suppose que vous aimeriez bien creer 
ce type de programmes, hmm? Eh bien. . . vous n'allez pas pouvoir de suite! 

En effet, creer des programmes avec des fenetres en C e'est possible, mais. . . quand on 
debute, e'est bien trop complique ! Pour debuter, il vaut mieux commencer par creer 
des programmes en console. 




f 



O 



Mais au fait, a quoi ca ressemble un programme en console? 
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Les programmes en console 

Les programmes console ont ete les premiers a apparaitre. A cette epoque, l'ordinateur 
ne gerait que le noir et blanc et il n'etait pas assez puissant pour creer des fenetres 
comme on le fait aujourd'hui. 

Bien entendu, le temps a passe depuis. Windows a rendu l'ordinateur « grand public » 
principalement grace a sa simplicite et au fait qu'il n'utilisait que des fenetres. Windows 
est devenu tellement populaire qu' aujourd'hui beaucoup de monde a oublie ce qu'etait 
la console 1 ! 

J'ai une grande nouvelle! La console n'est pas morte ! En effet, Linux a remis au 
gout du jour l'utilisation de la console. La fig. 3.2 est une capture d'ecran d'une console 
sous Linux. 
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Figure 3.2 - Un exemple de console, ici sous Linux 

Brrr. . . Terrifiant, hein ? Voila, vous avez maintenant une petite idee de ce a quoi 
ressemble une console. 

Ceci dit, plusieurs remarques : 

- aujourd'hui on sait afficher de la couleur, tout n'est done pas en noir et blanc comme 
on pourrait le croire ; 

- la console est assez peu accueillante pour un debutant ; 

- e'est pourtant un outil puissant quand on sait le maitriser. 

Comme je vous l'ai dit plus haut, creer des programmes en mode « console » comme 
ici, e'est tres facile et ideal pour debuter (ce qui n'est pas le cas des programmes en 
mode « fenetre »). 

Notez que la console a evolue : elle peut afficher des couleurs, et rien ne vous empeche 
de mettre une image de fond. 



1. Oui vous la, ne regardez pas derriere vous, je sais que vous vous demandez ce que e'est. 
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Et sous Windows? II n'y a pas de console? 



Si, mais elle est un peu. . . « cachee » on va dire. Vous pouvez avoir une console en 
faisant Demarrer / Accessoires / Invite de commandes, ou bien encore en faisant 
Demarrer / Exe cuter. . . , et en tapant ensuite cmd. 

La fig. 3.3 represente la maaagnifique console de Windows. 



@ I- '& - I ' 



j Administrates : C:\Windows\system32\crnd.exe 




Figure 3.3 - La console de Windows 



Si vous etes sous Windows, sachez done que e'est dans une fenetre qui ressemble a 
ca que nous ferons nos premiers programmes. Si j'ai choisi de commencer par des 
petits programmes en console, ce n'est pas pour vous ennuyer, bien au contraire ! En 
commengant par faire des programmes en console, vous apprendrez les bases necessaires 
pour pouvoir ensuite creer des fenetres. 

Soyez done rassures : des que nous aurons le niveau pour creer des fenetres, nous 
verrons comment en faire. 



Un minimum de code 



Pour n'importe quel programme, il faudra taper un minimum de code. Ce code ne fera 
rien de particulier mais il est indispensable. C'est ce « code minimum » que nous allons 
decouvrir maintenant. II devrait servir de base pour la plupart de vos programmes en 
langage C. 
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Demandez le code minimal a votre IDE 

Selon l'IDE que vous avez choisi dans le chapitre precedent, la methode pour creer 
un nouveau projet n'est pas la meme. Reportez-vous a ce chapitre si vous avez oublie 
comment faire. 

Pour rappel, sous Code: :Blocks (qui est l'IDE que je vais utiliser tout au long de 
ce cours), il faut aller dans le menu File / New / Project, puis choisir Console 
Application et selectionner le langage C. 

Code: :Blocks a done genere le minimum de code en langage C dont on a besoin. Le 
void : 

#include <stdio.h> 
#include <stdlib.h> 

int main ( ) 
{ 

printf ("Hello world!\n"); 

return ; 
} 



Notez qu'il y a une ligne vide a la fin de ce code. II est necessaire de taper sur 
la touche « Entree » apres la derniere accolade. Chaque fichier en C devrait 
normalement se terminer par une ligne vide. Si vous ne le faites pas, ce 
nest pas grave, mais le compilateur risque de vous afficher un avertissement 

(warning). 




a 



Notez que la ligne : 

I int main() 

. . . peut aussi s'ecrire : 

lint main (int argc, char *argv[]) 

Les deux ecritures sont possibles, mais la seconde (la compliquee) est la plus courante. 
J'aurai done tendance a utiliser plutot cette derniere dans les prochains chapitres. En 
ce qui nous concerne, que l'on utilise l'une ou l'autre des ecritures, <ja ne changera rien 
pour nous. Inutile done de s'y attarder, surtout que nous n'avons pas encore le niveau 
pour analyser ce que ca signifie. 

Si vous etes sous un autre IDE, copiez ce code source dans votre fichier main.c pour 
que nous ayons le meme code vous et moi. 

Enregistrez le tout. Oui je sais, on n'a encore rien fait, mais enregistrez quand meme, 
e'est une bonne habitude a prendre. Normalement, vous n'avez qu'un seul fichier source 
appele main.c (le reste, ce sont des fichiers de projet generes par votre IDE). 
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Analysons le code minimal 

Ce code minimal qu'on vient de voir n'est rien d'autre que du chinois pour vous, 
j'imagine. Et pourtant, moi je vois la un programme console qui affiche un message a 
l'ecran. II va falloir apprendre a lire tout ca! 

Commengons par les deux premieres lignes qui se ressemblent beaucoup : 

#include <stdio.h> 
#include <stdlib.h> 

Ce sont des lignes speciales que l'on ne voit qu'en haut des fichiers source. Ces lignes sont 
facilement reconnaissables car elles commencent par un diese #. Ces lignes speciales, 
on les appelle directives de preprocesseur (un nom complique, n'est-ce pas?). Ce 
sont des lignes qui seront lues par un programme appele preprocesseur, un programme 
qui se lance au debut de la compilation. 

Oui : comme je vous l'ai dit plus tot, ce qu'on a vu au debut n'etait qu'un schema tres 
simplifie de la compilation. II se passe en realite plusieurs choses pendant une compila- 
tion. On les detaillera plus tard : pour le moment, vous avez juste besoin d'inserer ces 
lignes en haut de chacun de vos fichiers. 




<? 



O 



Oui mais elles signifient quoi, ces lignes ? J'aimerais bien savoir quand meme I 



Le mot include en anglais signifie « inclure » en frangais. Ces lignes demandent d'in- 
clure des fichiers au projet, c'est-a-dire d'ajouter des fichiers pour la compilation. II y 
a deux lignes, done deux fichiers inclus. Ces fichiers s'appellent stdio.h et stdlib.h. 
Ces fichiers existent deja, des fichiers source tout prets. On verra plus tard qu'on les 
appelle des bibliotheques (certains parlent aussi de librairies mais e'est un angli- 
cisme). En gros, ces fichiers contiennent du code tout pret qui permet d'afficher du 
texte a l'ecran. 

Sans ces fichiers, ecrire du texte a l'ecran aurait ete mission impossible. L'ordinateur a 
la base ne sait rien faire, il faut tout lui dire. Vous voyez la galere dans laquelle on est ! 

Bref, en resume les deux premieres lignes incluent les bibliotheques qui vont nous 
permettre (entre autres) d'afficher du texte a l'ecran assez « facilement ». 

Passons a la suite. La suite, e'est tout ca : 

int main() 
{ 

printf ("Hello world!\n M ); 

return 0; 
} 

Ce que vous voyez la, e'est ce qu'on appelle une fonction. Un programme en langage 
C est constitue de fonctions, il ne contient quasiment que ga. Pour le moment, notre 
programme ne contient done qu'une seule fonction. 
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Une fonction permet grosso modo de rassembler plusieurs commandes a l'ordinateur. 
Regroupees dans une fonction, les commandes permettent de faire quelque chose de 
precis. Par exemple, on peut creer une fonction ouvrir_f ichier qui contiendra une 
suite d'instructions pour l'ordinateur lui expliquant comment ouvrir un fichier. L'avan- 
tage, c'est qu'une fois la fonction ecrite, vous n'aurez plus qu'a dire ouvrir_f ichier, 
et votre ordinateur saura comment faire sans que vous ayez a tout repeter ! 

Sans rentrer dans les details de la construction d'une fonction (il est trop tot, on repar- 
lera des fonctions plus tard), analysons quand meme ses grandes parties. La premiere 
ligne contient le nom de la fonction, c'est le deuxieme mot. Oui : notre fonction s'ap- 
pelle done main. C'est un nom de fonction particulier qui signifie « principal ». main 
est la fonction principale de votre programme, c'est toujours par la fonction main 
que le programme commence. 

Une fonction a un debut et une fin, delimites par des accolades { et >. Toute la fonction 
main se trouve done entre ces accolades. Si vous avez bien suivi, notre fonction main 
contient deux lignes : 

printf ("Hello world!\n"); 
return ; 

Ces lignes a l'interieur d'une fonction ont un nom. On les appelle instructions (ca 
en fait du vocabulaire qu'il va falloir retenir). Chaque instruction est une commande 
a l'ordinateur. Chacune de ces lignes demande a l'ordinateur de faire quelque chose de 
precis. 

Comme je vous l'ai dit un peu plus haut, en regroupant intelligemment (c'est le travail 
du programmeur) les instructions dans des fonctions, on cree si on veut des « bouts de 
programmes tout prets ». En utilisant les bonnes instructions, rien ne nous empecherait 
done de creer une fonction ouvrir_f ichier comme je vous l'ai explique tout a l'heure, 
ou encore une fonction avancer_personnage dans un jeu video, par exemple. 

Un programme, ce n'est au bout du compte rien d'autre qu'une serie d'instructions : 
« fais ceci », « fais cela ». Vous donnez des ordres a votre ordinateur et il les execute 2 . 



© 



Tres important : toute instruction se termine obligatoirement par un point- 
virgule « ; ». C'est d'ailleurs comme ca qu'on reconnatt ce qui est une ins- 
truction et ce qui n'en est pas une. Si vous oubliez de mettre un point-virgule 
a la fin d'une instruction, votre programme ne compilera pas! 



La premiere ligne : printf ("Hello world! \n") ; demande a afficher le message « Hello 
world ! » a l'ecran. Quand votre programme arrivera a cette ligne, il va done afficher 
un message a l'ecran, puis passer a l'instruction suivante. 

Passons a l'instruction suivante justement : return 0; Eh bien ca, en gros, ca veut dire 
que c'est fini (eh oui, deja). Cette ligne indique qu'on arrive a la fin de notre fonction 
main et demande de renvoyer la valeur 0. 



2. Du moins si vous l'avez bien dresse. 

37 



CHAPITRE 3. VOTRE PREMIER PROGRAMME 




Pourquoi mon programme renverrait-il le nombre 0? 



En fait, chaque programme une fois termine renvoie une valeur, par exemple pour 
dire que tout s'est bien passe 3 . La plupart du temps, cette valeur n'est pas vraiment 
utilisee, mais il faut quand meme en renvoyer une. Votre programme aurait marche 
sans le return 0, mais on va dire que c'est plus propre et plus serieux de le mettre, 
done on le met. 

Et voila ! On vient de detainer un peu le fonctionnement du code minimal. 

Certes, on n'a pas vraiment tout vu en profondeur, et vous devez avoir quelques ques- 
tions en suspens. Soyez rassures : toutes vos questions trouveront une reponse petit 
a petit. Je ne peux pas tout vous divulguer d'un coup, cela ferait trop de choses a 
assimiler. 

Vous suivez toujours? Si tel n'est pas le cas, rien ne presse. Ne vous forcez pas a lire 
la suite. Faites une pause et relisez ce debut de chapitre a tete reposee. Tout ce que je 
viens de vous apprendre est fondamental, surtout si vous voulez etre surs de pouvoir 
suivre apres. 

Tenez : comme je suis de bonne humeur, je vous fais un schema qui recapitule le 
vocabulaire qu'on vient d'apprendre (fig. 3.4). 



t include 
# include 



<stdii E ^h> / Directives de preprocesseur 



i tit rcain ( ) *N 

prmtf ,-Heiio w.ri<i!\n-) .-\| ns tructions VFonction 
' retnrn J 



Figure 3.4 - Le vocabulaire du programme minimal 



Testons notre programme 

Tester devrait aller vite. Tout ce que vous avez a faire c'est compiler le projet, puis 
l'executer (cliquez sur l'icone Build & Run sous Code: :Blocks). Si vous ne l'avez pas 
encore fait, on vous demandera d'enregistrer les fichiers. Faites-le. 

Apres un temps d'attente insupportable (la compilation), votre premier programme va 
apparaitre sous vos yeux totalement envahis de bonheur (fig. 3.5). 

Le programme affiche « Hello world ! » (sur la premiere ligne) . Les lignes en dessous 
ont ete generees par Code: :Blocks et indiquent que le programme s'est bien execute et 
combien de temps s'est ecoule depuis le lancement. 

On vous invite a appuyer sur n'importe quelle touche du clavier pour fermer la fenetre. 



3. En pratique, signifie « tout s'est bien passe » et n'importe quelle autre valeur signifie « erreur ». 
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Figure 3.5 - Votre premier programme ! 



Votre programme s'arrete alors' 



Ecrire un message a l'ecran 

A partir de maintenant, on va modifier nous-memes le code de ce programme minimal. 
Votre mission, si vous l'acceptez : afficher le message « Bonjour » a l'ecran. 

Comme tout a l'heure, une console doit s'ouvrir. Le message « Bonjour » doit s'afficher 
dans la console. 




H Comment fait-on pour choisir le texte qui s'affiche a l'ecran? 



Ce sera en fait assez simple. Si vous partez du code qui a ete donne plus haut, il vous 
suffit simplement de remplacer « Hello world ! » par « Bonjour » dans la ligne qui fait 
appel a printf . 

Comme je vous le disais plus tot, printf est une instruction. Elle commande a l'or- 
dinateur : « Affiche-moi ce message a l'ecran ». II faut savoir que printf est en fait 
une fonction qui a deja ete ecrite par d'autres programmeurs avant vous. 




<? 



O 



Cette fonction, ou se trouve-t-elle? Moi je ne vois que la fonction main ! 



4. Oui je sais, ce n'est pas transcendant. Mais bon, quand meme ! C'est un premier programme, un 
instant dont vous vous souviendrez toute votre vie ! . . . Non ? 
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Vous vous souvenez de ces deux lignes ? 

#include <stdio.h> 
#include <stdlib.h> 

Je vous avais dit qu'elles permettaient d'ajouter des bibliotheques dans votre pro- 
gramme. Les bibliotheques sont en fait des fichiers avec des tonnes de fonctions toutes 
pretes a l'interieur. Ces fichiers-la (stdio.h et stdlib.h) contiennent la plupart des 
fonctions de base dont on a besoin dans un programme, stdio.h en particulier contient 
des fonctions permettant d'affkher des choses a l'ecran (comme printf ) mais aussi de 
demander a l'utilisateur de taper quelque chose (ce sont des fonctions que l'on verra 
plus tard). 

Dis Bonjour au Monsieur 

Dans notre fonction main, on fait done appel a la fonction printf. C'est une fonction 
qui en appelle une autre (ici, main appelle printf). Vous allez voir que c'est tout le 
temps comme ga que <ja se passe en langage C : une fonction contient des instructions 
qui appellent d'autres fonctions, et ainsi de suite. 

Done, pour faire appel a une fonction, c'est simple : il suffit d'ecrire son nom, suivi de 
deux parentheses, puis un point-virgule. 

| printf () ; 

C'est bien, mais ce n'est pas suffisant. II faut indiquer quoi ecrire a l'ecran. Pour faire 
<ja, il faut donner a la fonction printf le texte a afficher. Pour ce faire, ouvrez des 
guillemets a l'interieur des parentheses et tapez le texte a afficher entre ces guillemets, 
comme cela avait deja ete fait sur le code minimal. 

Dans notre cas, on va done taper tres exactement : 

I printf ("Bonjour") ; 

J'espere que vous n'avez pas oublie le point-virgule a la fin, je vous rappelle que c'est 
tres important ! Cela permet d'indiquer que l'instruction s'arrete la. 

Voici le code source que vous devriez avoir sous les yeux : 

#include <stdio.h> 
#include <stdlib.h> 

int main() 
{ 

printf ("Bonjour") ; 

return ; 
} 
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On a done deux instructions qui commandent dans l'ordre a l'ordinateur : 

1. affiche « Bonjour » a l'ecran ; 

2. la fonction main est terminee, renvoie 0. Le programme s'arrete alors. 

La fig. 3.6 vous montre ce que donne ce programme a l'ecran. 




Figure 3.6 - Un programme poli qui dit Bonjour 

Comme vous pouvez le voir, la ligne du « Bonjour » est un peu collee avec le reste du 
texte, contrairement a tout a l'heure. Une des solutions pour rendre notre programme 
plus presentable serait de faire un retour a la ligne apres « Bonjour » (comme si on 
appuyait sur la touche « Entree »). 

Mais bien sur, ce serait trop simple de taper « Entree » dans notre code source pour 
qu'une entree soit effectuee a l'ecran ! II va falloir utiliser ce qu'on appelle des caracteres 
speciaux. . . 

Les caracteres speciaux 

Les caracteres speciaux sont des lettres speciales qui permettent d'indiquer qu'on veut 
aller a la ligne, faire une tabulation, etc. lis sont faciles a reconnaitre : e'est un en- 
semble de deux caracteres. Le premier d'entre eux est toujours un anti-slash ( \ ), et 
le second un nombre ou une lettre. Voici deux caracteres speciaux courants que vous 
aurez probablement besoin d'utiliser, ainsi que leur signification : 

- \n : retour a la ligne (= « Entree ») ; 

- \t : tabulation. 

Dans notre cas, pour faire une entree, il suffit de taper \n pour creer un retour a la 
ligne. Si je veux done faire un retour a la ligne juste apres le mot « Bonjour », je devrais 
taper : 

I printf ("Bonjour\n") ; 
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Votre ordinateur comprend qu'il doit afficher « Bonjour » suivi d'un retour a la ligne 
(fig. 3.7). 




Figure 3.7 - Le programme Bonjour avec un saut de ligne 
C'est deja un peu mieux, non? 




O 



Vous pouvez ecrire a la suite du \n sans aucun probleme. Tout ce que vous 

ecrirez a la suite du \n sera place sur la deuxieme ligne. Vous pourriez done 

vous entramer a ecrire : printf ( "Bonjour \nAu Revoir\n") ; 

Cela affichera « Bonjour » sur la premiere ligne et « Au revoir » sur la ligne 

suivante. 



Le syndrome de Gerard 




Bonjour, je m'appelle Gerard et j'ai voulu essayer de modifier votre programme 
pour qu'il me dise « Bonjour Gerard ». Seulement voila, j'ai I'impression que 
I'accent de Gerard ne s'affiche pas correctement. . . Que faire? 



Tout d'abord, bonjour Gerard. C'est une question tres interessante que vous nous 
posez la. Je tiens en premier lieu a vous feliciter pour votre esprit d'initiative, c'est tres 
bien d'avoir eu l'idee de modifier un peu le programme. C'est en « bidouillant » les 
programmes que je vous donne que vous allez en apprendre le plus. Ne vous contentez 
pas de ce que vous lisez, essayez un peu vos propres modifications des programmes que 
nous voyons ensemble ! 

Bien ! Maintenant, pour repondre a la question de notre ami Gerard, j'ai une bien triste 
nouvelle a vous annoncer : la console de Windows ne gere pas les accents. Par contre 
la console de Linux, oui. 

A partir de la vous avez deux solutions. 
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- Passer a Linux. C'est une solution un peu radicale et il me faudrait un cours entier 
pour vous expliquer comment vous servir de Linux. Si vous n'avez pas le niveau, 
oubliez cette possibilite pour le moment. 

- Ne pas utiliser d'accents. C'est malheureusement la solution que vous risquez 
de choisir. La console de Windows a ses defauts, que voulez-vous. II va vous fal- 
loir prendre l'habitude d'ecrire sans accents. Bien entendu, comme plus tard vous 
ferez probablement des programmes avec des fenetres, vous ne rencontrerez plus ce 
probleme-la. Je vous recommande done de ne pas utiliser d'accents temporairement, 
pendant votre apprentissage dans la console. Vos futurs programmes « profession- 
als » n'auront pas ce probleme, rassurez-vous. 

Pour ne pas etre gene, vous devrez done ecrire sans accent : 

I printf ("Bonjour Gerard\n") ; 

On remercie notre ami Gerard 5 pour nous avoir souleve ce probleme ! 

Les commentaires, c'est tres utile ! 

Avant de terminer ce premier chapitre de « veritable » programmation, je dois absolu- 
ment vous faire decouvrir les commentaires. Quel que soit le langage de programma- 
tion, on a la possibilite d'ajouter des commentaires a son code. Le langage C n'echappe 
pas a la regie. 

Qu'est-ce que 5a veut dire, « commenter » ? Cela signifie taper du texte au milieu de 
votre programme pour indiquer ce qu'il fait, a quoi sert telle ligne de code, etc. C'est 
vraiment quelque chose d'indispensable car, meme en etant un genie de la programma- 
tion, on a besoin de faire quelques annotations par-ci par-la. Cela permet : 

- de vous retrouver au milieu d'un de vos codes source plus tard. On ne dirait pas 
comme <ja, mais on oublie vite comment fonctionnent les programmes qu'on a ecrits. 
Si vous faites une pause ne serait-ce que quelques jours, vous aurez besoin de vous 
aider de vos propres commentaires pour vous retrouver dans un gros code ; 

- si vous donnez votre projet a quelqu'un d'autre (qui ne connait a priori pas votre 
code source) , cela lui permettra de se familiariser avec bien plus rapidement ; 

- enfin, <ja va me permettre a moi d'ajouter des annotations dans les codes source de 
ce cours. Et de mieux vous expliquer a quoi peut servir telle ou telle ligne de code. 

II y a plusieurs manieres d'inserer un commentaire. Tout depend de la longueur du 
commentaire que vous voulez ecrire. 

- Votre commentaire est court : il tient sur une seule ligne, il ne fait que quelques 
mots. Dans ce cas, vous devez taper un double slash (//) suivi de votre commentaire. 
Par exemple : 

I // Ceci est un commentaire 

5. Si d'aventure vous vous appeliez Gerard, sachez que je n'ai rien contre ce prenom. C'est simple- 
ment le premier prenom avec un accent qui m'est passe par la tete. . . Et puis bon, il faut toujours que 
quelqu'un prenne pour les autres, que voulez-vous ! 
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Vous pouvez aussi bien ecrire un commentaire seul sur sa ligne, ou bien a droite 
d'une instruction. C'est d'ailleurs quelque chose de tres pratique car ainsi, on sait 
que le commentaire sert a indiquer a quoi sert la ligne sur laquelle il est. Exemple : 

I printf ("Bonjour") ; // Cette instruction affiche Bonjour a l'ecran 

Notez que ce type de commentaire a normalement ete introduit par le langage CH — h, 

mais vous n'aurez pas de probleme en l'utilisant pour un programme en langage C 

aujourd'hui. 

Votre commentaire est long : vous avez beaucoup a dire, vous avez besoin d'ecrire 

plusieurs phrases qui tiennent sur plusieurs lignes. Dans ce cas, vous devez taper un 

code qui signifie « debut de commentaire » et un autre code qui signifie « fin de 

commentaire » : 

- pour indiquer le debut du commentaire : tapez un slash suivi d'une etoile (/*) ; 

- pour indiquer la fin du commentaire : tapez une etoile suivie d'un slash (*/). 
Vous ecrirez done par exemple : 

/* Ceci est 

un commentaire 

sur plusieurs lignes */ 

Reprenons notre code source qui ecrit « Bonjour », et ajoutons-lui quelques commen- 
taires juste pour s'entrainer : 

/* 

Ci-dessous, ce sont des directives de preprocesseur . 

Ces lignes permettent d'aj outer des fichiers au pro jet, 

fichiers que l'on appelle bibliotheques . 

Grace a ces bibliotheques, on disposera de fonctions toutes pretes pour afficher 

par exemple un message a l'ecran. 

*/ 

#include <stdio.h> 
#include <stdlib.h> 

/* 

Ci-dessous, vous avez la fonction principale du programme, appelee main. 
C'est par cette fonction que tous les programmes commencent . 
Ici, ma fonction se contente d' afficher Bonjour a l'ecran. 
*/ 

int mainO 

{ 

printf ("Bonjour") ; // Cette instruction affiche Bonjour a l'ecran 
return 0; // Le programme renvoie le nombre puis s'arrete 

} 

Voila ce que donnerait notre programme avec quelques commentaires. Oui, il a l'air 
d'etre plus gros, mais en fait c'est le meme que tout a l'heure. Lors de la compilation, 
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tous les comment aires seront ignores. Ces commentaires n'apparaitront pas dans le 
programme final, ils servent seulement aux programmeurs. 

Normalement, on ne commente pas chaque ligne du programme. J'ai dit (et je le re- 
dirai) que c'etait important de mettre des commentaires dans un code source, mais il 
faut savoir doser : commenter chaque ligne ne servira la plupart du temps a rien. A 
force, vous saurez que le printf permet d'afficher un message a l'ecran, pas besoin de 
l'indiquer a chaque fois. 

Le mieux est de commenter plusieurs lignes a la fois, c'est-a-dire d'indiquer a quoi 
sert une serie d'instructions histoire d'avoir une idee. Apres, si le programmeur veut se 
pencher plus en detail dans ces instructions, il est assez intelligent pour y arriver tout 
seul. 

Retenez done : les commentaires doivent guider le programmeur dans son code source, 
lui permettre de se reperer. Essayez de commenter un ensemble de lignes plutot que 
toutes les lignes une par une. 

Et pour finir sur une petite touche culturelle, voici une citation tiree de chez IBM : 

Si apres avoir lu uniquement les commentaires d'un programme vous 
n'en comprenez pas le fonctionnement, jetez le tout ! 



En resume 

- Les programmes peuvent communiquer avec l'utilisateur via une console ou une 
fenetre. 

- II est beaucoup plus facile pour nos premiers programmes de travailler avec la 
console, bien que celle-ci soit moins attirante pour un debutant 6 . 

- Un programme est constitue d'instructions qui se terminent toutes par un point- 
virgule. 

- Les instructions sont contenues dans des fonctions qui permettent de les classer, 
comme dans des boites. 

- La fonction main (qui signifie « principale ») est la fonction par laquelle demarre 
votre programme. C'est la seule qui soit obligatoire, aucun programme ne peut etre 
compile sans elle. 

- printf est une fonction toute prete qui permet d'afficher un message a l'ecran dans 
une console. 

- printf se trouve dans une bibliotheque ou l'on retrouve de nombreuses autres 
fonctions pretes a l'emploi. 



6. Cela ne nous empechera pas par la suite de travailler avec des fenetres dans la partie III. Tout 
vient a point a qui sait attendre. ;-) 
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Chapitre 
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Un monde de variables 



Vous savez afficher un texte a I'ecran. Tres bien. Ca ne vole peut-etre pas tres haut 
pour le moment, mais c'est justement parce que vous ne connaissez pas encore ce 
qu'on appelle les variables en programmation. 

Le principe dans les grandes lignes, c'est de faire retenir des nombres a I'ordinateur. On va 
apprendre a stocker des nombres dans la memoire. 

Je souhaite que nous commencions par quelques explications sur la memoire de votre 
ordinateur. Comment fonctionne une memoire? Combien un ordinateur possede-t-il de 
memoires differentes? Cela pourra paraTtre un peu simpliste a certains d'entre vous, mais 
je pense aussi a ceux qui ne savent pas bien ce qu'est une memoire. 
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Une affaire de memoire 

Ce que je vais vous apprendre dans ce chapitre a un rapport direct avec la memoire de 
votre ordinateur. 

Tout etre humain normalement constitue a une memoire. Eh bien c'est pareil pour un 
ordinateur. . . a un detail pres : un ordinateur a plusieurs types de memoire ! 

>\ Pourquoi un ordinateur aurait-il plusieurs types de memoire? Une seule me- 
moire aurait suffi, non ? 



Non : en fait, le probleme c'est qu'on a besoin d'avoir une memoire a la fois rapide 
(pour recuperer une information tres vite) et importante (pour stocker beaucoup 
de donnees). Or, vous allez rire, mais jusqu'ici nous avons ete incapables de creer une 
memoire qui soit a la fois tres rapide et importante. Plus exactement, la memoire rapide 
coute cher, on n'en fait done qu'en petites quantites. 

Du coup, pour nous arranger, nous avons du doter les ordinateurs de memoires tres 
rapides mais pas importantes, et de memoires importantes mais pas tres rapides (vous 
suivez toujours?). 

Les differents types de memoire 

Pour vous donner une idee, voici les differents types de memoire existant dans un 
ordinateur, de la plus rapide a la plus lente : 

1. les registres : une memoire ultra- rapide situee directement dans le processeur; 

2. la memoire cache : elle fait le lien entre les registres et la memoire vive; 

3. la memoire vive : c'est la memoire avec laquelle nous aliens travailler le plus 
souvent ; 

4. le disque dur : que vous connaissez surement, c'est la qu'on enregistre les fichiers. 

Comme je vous l'ai dit, j'ai classe les memoires de la plus rapide (les registres) a la plus 
lente (le disque dur). Si vous avez bien suivi, vous avez compris aussi que la memoire 
la plus rapide etait la plus petite, et la plus lente la plus grosse. Les registres sont done 
a peine capables de retenir quelques nombres, tandis que le disque dur peut stocker de 
tres gros fichiers. 

Quand je dis qu'une memoire est « lente », c'est a I'echelle de votre ordinateur 
bien sur. Eh oui : pour un ordinateur, 8 millisecondes pour acceder au disque 
dur, c'est deja trop long I 




a 



Que faut-il retenir dans tout ca? En fait, je souhaite vous situer un peu. Vous savez 
desormais qu'en programmation, on va surtout travailler avec la memoire vive. On 
verra aussi comment lire et ecrire sur le disque dur, pour lire et creer des fichiers (mais 
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on ne le fera que plus tard). Quant a la memoire cache et aux registres, on n'y touchera 
pas du tout ! C'est votre ordinateur qui s'en occupe. 

Dans des langages tres bas niveau, comme I'assembleur (abrege « ASM »), 
on travaille au contraire plutot directement avec les registres. Je I'ai fait, et 
je peux vous dire que faire une simple multiplication dans ce langage est un 
veritable parcours du combattant I Heureusement, en langage C (et dans la 
plupart des autres langages de programmation), c'est beaucoup plus facile. 
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II faut aj outer une derniere chose tres importante : seul le disque dur retient tout le 
temps les informations qu'il contient. Toutes les autres memoires (registres, memoire 
cache, memoire vive) sont des memoires temporaires : lorsque vous eteignez votre 
ordinateur, ces memoires se vident ! 

Heureusement, lorsque vous rallumerez l'ordinateur, votre disque dur sera toujours la 
pour rappeler a votre ordinateur qui il est. 

La memoire vive en photos 

Vu qu'on va travailler pendant un moment avec la memoire vive, je pense qu'il serait 
bien de vous la presenter. 

On va y aller par zooms successifs. Commencons par votre ordinateur (fig. 4.1). 



JB 



Figure 4.1 - Un ordinateur et tous ses composants 

Vous reconnaissez le clavier, la souris, l'ecran et l'unite centrale (la tour). Interessons- 
nous maintenant a l'unite centrale (fig. 4.2), le cceur de votre ordinateur qui contient 
toutes les memoires. 




Figure 4.2 - L'unite centrale 
Ce qui nous interesse, c'est ce qu'il y a a l'interieur de l'unite centrale. Ouvrons-la (fig. 
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4.3). 




Figure 4.3 - Interieur de l'unite centrale 

C'est un joyeux petit bazar. Rassurez-vous, je ne vous demanderai pas de savoir com- 
ment tout cela fonctionne. Je veux juste que vous sachiez ou se trouve la memoire vive 
la-dedans. Je vous l'ai encadree. Je n'ai pas indique les autres memoires (registres et 
memoire cache) car de toute fagon elles sont bien trop petites pour etre visibles a l'oeil 
nu. 

Voici a quoi ressemble une barrette de memoire vive de plus pres (fig. 4.4). 




Figure 4.4 - Une barrette de memoire vive 

La memoire vive est aussi appelee RAM, ne vous etonnez done pas si par la suite 
j'utilise plutot le mot RAM qui est un peu plus court. 
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Le schema de la memoire vive 

En photographiant de plus pres la memoire vive, on n'y verrait pas grand-chose. Pour- 
tant, il est tres important de savoir comment <ja fonctionne a l'interieur. C'est d'ailleurs 
la que je veux en venir depuis tout a l'heure. 

Je vous propose un schema du fonctionnement de la memoire vive (fig. 4.5). II est tres 
simplifies (comme mes schemas de compilation !), mais c'est parce que nous n'avons pas 
besoin de trop de details. Si vous retenez ce schema, ce sera deja tres bien ! 



Adresse 



Valeur 



145 



3.8028322 



0.827551 



3901930 



3 448 765 900 126 
(et des poussieres) 



940.5118 



Figure 4.5 - Organisation de la memoire vive 

Comme vous le voyez, il faut en gros distinguer deux colonnes. 

- II y a les adresses : une adresse est un nombre qui permet a l'ordinateur de se reperer 
dans la memoire vive. On commence a l'adresse (au tout debut de la memoire) et 
on finit a l'adresse 3 448 765 900 126 et des poussieres. . . Euh, en fait je ne connais 
pas le nombre d'adresses qu'il y a dans la RAM, je sais juste qu'il y en a beaucoup. 
En plus ga depend de la quantite de memoire vive que vous avez. Plus vous avez de 
memoire vive, plus il y a d'adresses, done plus on peut stocker de choses. 

- A chaque adresse, on peut stocker une valeur (un nombre) : votre ordinateur stocke 
dans la memoire vive ces nombres pour pouvoir s'en souvenir par la suite. On ne 
peut stocker qu'un nombre par adresse ! 

Notre RAM ne peut stocker que des nombres. 
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Mais alors, comment fait-on pour retenir des mots? 



Bonne question. En fait, meme les lettres ne sont que des nombres pour l'ordinateur ! 
Une phrase est une simple succession de nombres. II existe un tableau qui fait la cor- 
respondance entre les nombres et les lettres. C'est un tableau qui dit par exemple : le 
nombre 61 correspond a la lettre Y. Je ne rentre pas dans les details, on aura l'occasion 
de reparler de cela plus loin dans le cours. 

Revenons a notre schema. Les choses sont en fait tres simples : si l'ordinateur veut 
retenir le nombre 5 (qui pourrait etre le nombre de vies qu'il reste au personnage 
d'un jeu), il le met quelque part en memoire ou il y a de la place et note l'adresse 
correspondante (par exemple 3 062 199 902). Plus tard, lorsqu'il veut savoir a nouveau 
quel est ce nombre, il va chercher a la « case » memoire n ° 3 062 199 902 ce qu'il y a, 
et il trouve la valeur. . . 5 ! 

Voila en gros comment ga fonctionne. C'est peut-etre un peu flou pour le moment 
(quel interet de stocker un nombre s'il faut a la place retenir l'adresse?) mais tout va 
rapidement prendre du sens dans la suite de ce chapitre, je vous le promets. 



Declarer une variable 

Croyez-moi, cette petite introduction sur la memoire va nous etre plus utile que vous 
ne le pensez. Maintenant que vous savez ce qu'il faut, on peut retourner programmer. 

Alors une variable, c'est quoi ? Eh bien c'est une petite information temporaire qu'on 
stocke dans la RAM. Tout simplement. On dit qu'elle est « variable » car c'est une 
valeur qui peut changer pendant le deroulement du programme. Par exemple, notre 
nombre 5 de tout a l'heure (le nombre de vies restant au joueur) risque de diminuer au 
fil du temps. Si ce nombre atteint 0, on saura que le joueur a perdu. 

Nos programmes, vous allez le voir, sont remplis de variables. Vous allez en voir partout, 
a toutes les sauces. 

En langage C, une variable est constitute de deux choses : 

- une valeur : c'est le nombre qu'elle stocke, par exemple 5 ; 

- un nom : c'est ce qui permet de la reconnaitre. En programmant en C, on n'aura 
pas a retenir l'adresse memoire (ouf !) : a la place, on va juste indiquer des noms de 
variables. C'est le compilateur qui fera la conversion entre le nom et l'adresse. Voila 
deja un souci de moins. 

Donner un nom a ses variables 

En langage C, chaque variable doit done avoir un nom. Pour notre fameuse variable 
qui retient le nombre de vies, on aimerait bien l'appeler « Nombre de vies » ou quelque 
chose du genre. 
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Helas, il y a quelques contraintes. Vous ne pouvez pas appeler une variable n'importe 
comment : 

- il ne peut y avoir que des minuscules, majuscules et des chiffres (abcABC012) ; 

- votre nom de variable doit commencer par une lettre ; 

- les espaces sont interdits. A la place, on peut utiliser le caractere « underscore » 
_ (qui ressemble a un trait de soulignement). C'est le seul caractere different des 
lettres et chiffres autorise ; 

- vous n'avez pas le droit d'utiliser des accents (eae etc.). 

Enfin, et c'est tres important a savoir, le langage C fait la difference entre les majus- 
cules et les minuscules. Pour votre culture, sachez qu'on dit que c'est un langage qui 
« respecte la casse ». Done, du coup, les variables largeur, LARGEUR ou encore LArgEuR 
sont trois variables differentes en langage C, meme si pour nous ca a l'air de signifier 
la meme chose ! 

Voici quelques exemples de noms de variables corrects : nombreDeVies, prenom, nom, 
numero_de_teleprione, numeroDeTelephone. 

Chaque programmeur a sa propre facon de nommer des variables. Pendant ce cours, je 
vais vous montrer ma maniere de faire : 

- je commence tous mes noms de variables par une lettre minuscule; 

- s'il y a plusieurs mots dans mon nom de variable, je mets une lettre majuscule au 
debut de chaque nouveau mot. 

Je vais vous demander de faire de la meme maniere que moi, ga nous permettra d'etre 
sur la meme longueur d'ondes. 
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Quoi que vous fassiez, faites en sorte de donner des noms clairs a vos variables. 
On aurait pu abreger nombreDeVies, en I'ecrivant par exemple ndv. C'est 
peut-etre plus court, mais c'est beaucoup moins clair pour vous quand vous 
relisez votre code. N'ayez done pas peur de donner des noms un peu plus 
longs pour que ca reste comprehensible. 



Les types de variables 

Notre ordinateur, vous pourrez le constater, n'est en fait rien d'autre qu'une (tres 
grosse) machine a calculer. II ne sait traiter que des nombres. 

Oui mais voila, j'ai un scoop ! II existe plusieurs types de nombres ! Par exemple, il y a 
les nombres entiers positifs : 

- 45; 

- 398; 

- 7650. 

Mais il y a aussi des nombres decimaux, e'est-a-dire des nombres a virgule : 

- 75,909; 

- 1,7741; 
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- 9810,7. 

En plus de ga, il y a aussi des nombres entiers negatifs : 

--87; 

- -916. 

. . . Et des nombres negatifs decimaux ! 

--76,9; 

- -100,11. 

Votre pauvre ordinateur a besoin d'aide ! Lorsque vous lui demandez de stocker un 
nombre, vous devez dire de quel type il est. Ce n'est pas vraiment qu'il ne soit pas 
capable de le reconnaitre tout seul, mais. . . <ja l'aide beaucoup a s'organiser, et a faire 
en sorte de ne pas prendre trop de memoire pour rien. 

Lorsque vous creez une variable, vous allez done devoir indiquer son type. Voici les 
principaux types de variables existant en langage C : 



Nom du type 


Nombres stockables 


char 


-128 a 127 


int 


-2 147 483 648 a 2 147 483 647 


long 


-2 147 483 648 a 2 147 483 647 


float 


-3.4 x 10 puissance 38 a 3.4 x 10 puissance 38 


double 


-1.7 x 10 puissance 308 a 1.7 x 10 puissance 308 



(Je suis loin d' avoir mis tous les types, mais j'ai conserve les principaux) 

Les trois premiers types (char, int, long) permettent de stocker des nombres entiers : 
1, 2, 3, 4... Les deux derniers (float, double) permettent de stocker des nombres 
decimaux : 13.8, 16.911... 




O 



Les types float et double permettent de stocker des nombres de- 
cimaux extremement grands. Si vous ne connaissez pas les puis- 
sances de 10, dites-vous par exemple que le type double per- 
met de stocker le nombre 1 suivi de 308 zeros derriere I C'est-a- 
dire : 10000000000000000000000000000000000000000000000000000. . . (je 
ne vais quand meme pas ecrire 308 zeros pour vous I). 
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Vous remarquerez qu'un int et un long ont I'air identiques. Avant ce n'etait 
pas le cas (un int etait plus petit qu'un long), mais aujourd'hui les memoires 
ont evolue et on a assez de place pour stocker des grands nombres, on se 
moque done un peu de la difference entre un int et un long. Le langage 
C « conserve » tous ces types pour des raisons de compatibility, meme si 
certains sont un peu de trop. En pratique, j utilise principalement char, int 
et double. 



Vous verrez que la plupart du temps on manipule des nombres entiers (tant mieux, 
parce que e'est plus facile a utiliser). 
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Attention avec les nombres decimaux! Votre ordinateur ne connaTt pas la 
virgule, il utilise le point. Vous ne devez done pas ecrire 54,9 mais plutot 
54.9! 



Ce n'est pas tout! Pour les types stockant des entiers (char, int, long...), il existe 
d'autres types dits unsigned (non signes) qui eux ne peuvent stocker que des nombres 
positifs. Pour les utiliser, il suffit d'ecrire le mot unsigned devant le type : 



unsigned char a 255 



unsigned int a 4 294 967 295 
unsigned long a 4 294 967 295 




Comme vous le voyez, les unsigned sont des types qui ont le defaut de ne pas pouvoir 
stocker de nombres negatifs, mais l'avantage de pouvoir stocker des nombres deux fois 
plus grands (char s'arrete a 128, tandis que unsigned char s'arrete a 255 par exemple). 

Pourquoi avoir cree trois types pour les nombres entiers? Un seul type aurait 
ete suffisant, non ? 



Oui, mais on a cree a l'origine plusieurs types pour economiser de la memoire. Ainsi, 
quand on dit a l'ordinateur qu'on a besoin d'une variable de type char, on prend moins 
d'espace en memoire que si on avait demande une variable de type int. 

Toutefois, e'etait utile surtout a l'epoque ou la memoire etait limitee. Aujourd'hui, nos 
ordinateurs ont largement assez de memoire vive pour que ca ne soit plus vraiment un 
probleme. II ne sera done pas utile de se prendre la tete pendant des heures sur le choix 
d'un type. Si vous ne savez pas si votre variable risque de prendre une grosse valeur, 
mettez int. 

En resume, on fera surtout la distinction entre nombres entiers et decimaux : 

- pour un nombre entier, on utilisera le plus souvent int ; 

- pour un nombre decimal, on utilisera generalement double. 

Declarer une variable 

On y arrive. Maintenant, creez un nouveau projet console que vous appellerez « va- 
riables ». On va voir comment declarer une variable, e'est-a-dire demander a l'ordi- 
nateur la permission d'utiliser un peu de memoire. 

Une declaration de variable, e'est tres simple maintenant que vous savez tout ce qu'il 
faut. II suffit dans l'ordre : 

1. d'indiquer le type de la variable que l'on veut creer; 

2. d'inserer un espace ; 

3. d'indiquer le nom que vous voulez donner a la variable ; 

4. et enfin, de ne pas oublier le point-virgule. 
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Par exemple, si je veux creer ma variable nombreDeVies de type int, je dois taper la 
ligne suivante : 

I int nombreDeVies ; 

Et c'est tout ! Quelques autres exemples stupides pour la forme : 

int noteDeMaths ; 

double sommeArgentRecue; 

unsigned int nombreDeLecteursEnTrainDeLireUnNomDeVariableUnPeuLong ; 

Bon bref, vous avez compris le principe je pense ! 

Ce qu'on fait la s'appelle une declaration de variable (un vocabulaire a retenir). 
Vous devez faire les declarations de variables au debut des fonctions. Comme pour le 
moment on n'a qu'une seule fonction (la fonction main), vous allez declarer la variable 
comme ceci : 



#include <stdio.h> 
#include <stdlib.h> 

int main(int argc, char *argv[]) // Equivalent de int main() 
{ 

int nombreDeVies ; 

return ; 
} 



Si vous lancez le programme ci-dessus, vous constaterez avec stupeur. . . qu'il ne fait 
rien. 



Quelques explications 

Alors, avant que vous ne m'etrangliez en croyant que je vous mene en bateau depuis 
tout a l'heure, laissez-moi juste dire une chose pour ma defense. 

En fait, il se passe des choses, mais vous ne les voyez pas. Lorsque le programme arrive 
a la ligne de la declaration de variable, il demande bien gentiment a l'ordinateur s'il 
peut utiliser un peu d'espace dans la memoire vive. Si tout va bien, l'ordinateur repond 
« Oui bien sur, fais comme chez toi ». Generalement, cela se passe sans probleme 1 . 

Soyez done sans crainte, vos variables devraient normalement etre creees sans souci. 



1. Le seul probleme qu'il pourrait y avoir, c'est qu'il n'y ait plus de place en memoire... Mais 
heureusement cela arrive rarement, car pour remplir toute la memoire rien qu'avec des int il faut 
vraiment le vouloir ! 
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Une petite astuce a connaTtre : si vous avez plusieurs variables du meme type 
a declarer, inutile de faire une ligne pour chaque variable. II vous suffit de 
separer les differents noms de variables par des virgules sur la meme ligne : 

int nombreDeVies , niveau, ageDuJoueur; 

Cela creera trois variables int appelees nombreDeVies, niveau et 
ageDuJoueur. 



Et maintenant ? Maintenant qu'on a cree notre variable, on va pouvoir lui donner une 
valeur. 



Affecter une valeur a une variable 

C'est tout ce qu'il y a de plus bete. Si vous voulez donner une valeur a la variable 
nombreDeVies, il suffit de proceder comme ceci : 

I nombreDeVies = 5; 

Rien de plus a faire. Vous indiquez le nom de la variable, un signe egal, puis la valeur 
que vous voulez y mettre. Ici, on vient de donner la valeur 5 a la variable nombreDeVies. 
Notre programme complet ressemble done a ceci : 

#include <stdio.h> 
#include <stdlib.h> 

int main (int argc, char *argv[]) 
{ 

int nombreDeVies; 

nombreDeVies = 5; 

return 0; 
} 

La encore, rien ne s'affiche a l'ecran, tout se passe dans la memoire. Quelque part dans 
les trefonds de votre ordinateur, une petite case de memoire vient de prendre la valeur 
5. N'est-ce pas magnifique? 

On peut s'amuser si on veut a changer la valeur par la suite : 

int nombreDeVies 
nombreDeVies = 5 
nombreDeVies = 4 
nombreDeVies = 3 

Dans cet exemple, la variable va prendre d'abord la valeur 5, puis 4, et enfin 3. Comme 
votre ordinateur est tres rapide, tout cela se passe extremement vite. Vous n'avez pas 
le temps de cligner des yeux que votre variable vient de prendre les valeurs 5, 4 et 3. . . 
et ga y est, votre programme est fini. 
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La valeur d'une nouvelle variable 

Voici une question tres importante que je veux vous soumettre 



Quand on declare une variable, quelle valeur a-t-elle au depart? 
O 



En effet, quand l'ordinateur lit cette ligne : 

I int nombreDeVies ; 

il reserve un petit emplacement en memoire, d'accord. Mais quelle est la valeur de la 
variable a ce moment-la ? Y a-t-il une valeur par defaut (par exemple 0) ? 

Eh bien, accrochez-vous : la reponse est non. Non, non et non, il n'y a pas de valeur par 
defaut. En fait, l'emplacement est reserve mais la valeur ne change pas. On n'efface pas 
ce qui se trouve dans la « case memoire ». Du coup, votre variable prend la valeur qui 
se trouvait la avant dans la memoire, et cette valeur peut etre n'importe quoi ! 

Si cette zone de la memoire n'a jamais ete modifiee, la valeur est peut-etre 0. Mais 
vous n'en etes pas surs, il pourrait tres bien y avoir le nombre 363 ou 18 a la place, 
c'est-a-dire un reste d'un vieux programme qui est passe par la avant ! II faut done faire 
tres attention a §a si on veut eviter des problemes par la suite. Le mieux est d'initialiser 
la variable des qu'on la declare. En C, e'est tout a fait possible. En gros, qa consiste a 
combiner la declaration et l'affectation d'une variable dans la meme instruction : 

lint nombreDeVies = 5; 

Ici, la variable nombreDeVies est declaree et prend tout de suite la valeur 5. L'avantage, 
e'est que vous etes surs apres que cette variable contient une valeur correcte, et pas du 
n'importe quoi. 

Les constantes 

II arrive parfois que l'on ait besoin d'utiliser une variable dont on voudrait qu'elle garde 
la meme valeur pendant toute la duree du programme. C'est-a-dire qu'une fois declaree, 
vous voudriez que votre variable conserve sa valeur et que personne n'ait le droit de 
changer ce qu'elle contient. 

Ces variables particulieres sont appelees constantes, justement parce que leur valeur 
reste constante. 

Pour declarer une constante, e'est en fait tres simple : il faut utiliser le mot const juste 
devant le type quand vous declarez votre variable. Par ailleurs, il faut obligatoirement 
lui donner une valeur au moment de sa declaration comme on vient d'apprendre a le 
faire. Apres, il sera trop tard : vous ne pourrez plus changer la valeur de la constante. 

Exemple de declaration de constante : 
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| const int NOMBRE_DE_VIES_INITIALES = 5; 



Ce n'est pas une obligation, mais par convention on ecrit les noms des 
constantes entierement en majuscules comme je viens de le faire la. Cela 
nous permet ainsi de distinguer facilement les constantes des variables. Notez 
qu'on utilise I'underscore _ a la place de lespace. 




a 



A part <ja, une constante s'utilise comme une variable normale, vous pouvez afficher sa 
valeur si vous le desirez. La seule chose qui change, c'est que si vous essayez de modifier 
la valeur de la constante plus loin dans le programme, le compilateur vous indiquera 
qu'il y a une erreur avec cette constante. 

Les erreurs de compilation sont affichees en bas de l'ecran (dans ce que j'appelle la 
« zone de la mort », vous vous souvenez?). Dans un tel cas, le compilateur vous 
afficherait un mot doux du genre : [Warning] assignment of read-only variable 
'NOMBRE DE VIES INITIALES' 2 . 



Afficher le contenu d'une variable 

On sait afficher du texte a l'ecran avec la fonction printf . Maintenant, on va voir 
comment afficher la valeur d'une variable avec cette meme fonction. 

On utilise en fait printf de la meme maniere, sauf que l'on rajoute un symbole special 
a l'endroit ou l'on veut afficher la valeur de la variable. Par exemple : 

IprintfC'Il vous reste '/,d vies"); 

Ce « symbole special » dont je viens de vous parler est en fait un % suivi de la lettre 
« d ». Cette lettre permet d'indiquer ce que l'on doit afficher. « d » signifie que c'est un 
nombre entier. II existe plusieurs autres possibilites, mais pour des raisons de simplicity 
on va se contenter de retenir ces deux-la : 



Symbole 


Signification 


Id 


Nombre entier (ex. : 4) 


If 


Nombre decimal (ex. : 5.18) 



Je vous parlerai des autres symboles en temps voulu. Pour le moment, sachez que si 
vous voulez afficher un int vous devez utiliser °/,d, et pour un double vous utiliserez 
If. 

On a presque fini. On a indique qu'a un endroit precis on voulait afficher un nombre 
entier, mais on n'a pas precise lequel ! II faut done indiquer a la fonction printf quelle 
est la variable dont on veut afficher la valeur. Pour ce faire, vous devez taper le nom 
de la variable apres les guillemets et apres avoir rajoute une virgule, comme ceci : 



2. Traduction : « Triple idiot, pourquoi tu essaies de modifier la valeur d'une constante ? » 
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I printf ("II vous reste '/,d vies", nombreDeVies) ; 

Le 7,d sera remplace par la variable indiquee apres la virgule, a savoir nombreDeVies. 
On se teste <ja dans un programme ? 

#include <stdio.h> 
#include <stdlib.h> 

int main(int argc, char *argv[]) 
{ 

int nombreDeVies =5; // Au depart, le joueur a 5 vies 

printf ("Vous avez */,d vies\n", nombreDeVies); 

printf ("**** BAM ****\n") ; // La il se prend un grand coup sur la tete 
nombreDeVies = 4; // II vient de perdre une vie ! 

printf ("Ah desole, il ne vous reste plus que */,d vies maintenant ! \n\n" , 
^-> nombreDeVies) ; 

return ; 
} 



Ca pourrait presque etre un jeu video (il faut juste beaucoup d'imagination). Ce pro- 
gramme affiche ceci a l'ecran : 



Vous 


avez 


5 vies 


















**** 


BAM 


**** 


















Ah desole, 


il ne 


vous 


re 


ste 


plus 


que 


4 


vies 


maintenant ! 



Vous devriez reconnaitre ce qui se passe dans votre programme. 

1. Au depart le joueur a 5 vies, on affiche <ja dans un printf. 

2. Ensuite, le joueur prend un coup sur la tete (d'ou le BAM). 

3. Finalement il n'a plus que 4 vies, on affiche <ja aussi avec un printf. 

Bref, c'est plutot simple. 

Afficher plusieurs variables dans un meme printf 

II est possible d'afficher la valeur de plusieurs variables dans un seul printf. II vous 
suffit pour cela d'indiquer des °/„d ou des °/„f la ou vous voulez, puis d'indiquer les 
variables correspondantes dans le meme ordre, separees par des virgules. 

Par exemple : 

I printf ("Vous avez '/,d vies et vous etes au niveau n° '/,d", nombreDeVies, niveau); 
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Veillez a bien indiquer vos variables dans le bon ordre. Le premier °/„d sera 
remplace par la premiere variable (nombreDeVies), et le second 7„d par la 
seconde variable (niveau). Si vous vous trompez d'ordre, votre phrase ne 
voudra plus rien dire. 



Allez, un petit test maintenant. Notez que j'enleve les lignes tout en haut (les directives 
de preprocesseur commengant par un jf), je vais supposer que vous les mettez a chaque 
fois maintenant : 

int main(int argc, char *argv[]) 
{ 

int nombreDeVies = 5, niveau = 1; 

printf ("Vous avez */,d vies et vous etes au niveau n° '/,d\n", nombreDeVies, niveau 

<-> ); 

return 0; 
} 

Ce qui affichera : 



Vous avez 5 vies et vous etes au niveau n° 1 



Recuperer une saisie 



Les variables vont en fait commencer a devenir interessantes maintenant. On va ap- 
prendre a demander a l'utilisateur de taper un nombre dans la console. Ce nombre, on 
va le recuperer et le stocker dans une variable. Une fois que ga sera fait, on pourra faire 
tout un tas de choses avec, vous verrez. 

Pour demander a l'utilisateur d'entrer quelque chose dans la console, on va utiliser une 
autre fonction toute prete : scanf . Cette fonction ressemble beaucoup a printf. Vous 
devez mettre un °/,d pour indiquer que l'utilisateur doit entrer un nombre entier (pour 
les decimaux, je vais y revenir). Puis vous devez ensuite indiquer le nom de la variable 
qui va recevoir le nombre. 

Voici comment faire par exemple : 

int age = ; 
scanf (" 4 /,d" , ftage) ; 

On doit mettre le °/„d entre guillemets. Par ailleurs, il faut mettre le symbole & devant 
le nom de la variable qui va recevoir la valeur. 




<? 



Euh, pourquoi mettre un & devant le nom de la variable? 
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La, il va falloir que vous me fassiez confiance. Si je dois vous expliquer ca tout de suite, 
on n'est pas sortis de l'auberge, croyez-moi ! Que je vous rassure quand meme : je vous 
expliquerai un peu plus tard ce que signifie ce symbole. Pour le moment, je choisis de 
ne pas vous l'expliquer pour ne pas vous embrouiller, c'est done plutot un service que 
je vous rends la ! 



© 



Attention : si vous voulez faire entrer un nombre decimal (de type double), 
cette fois il ne faut pas utiliser °/„f comme on pourrait s'y attendre mais. . . 
7,lf . C'est une petite difference avec le printf qui lui prenait °/,f . 

double poids = 0; 
scanf ("*/,lf " , ftpoids) ; 



Revenons a notre programme. Lorsque celui-ci arrive a un scanf, il se met en pause et 
attend que l'utilisateur entre un nombre. Ce nombre sera stocke dans la variable age. 

Voici un petit programme simple qui demande Page de l'utilisateur et qui le lui afHche 
ensuite : 

int main(int argc, char *argv[]) 
{ 

int age =0; //On initialise la variable a 

printf ("Quel age avez-vous ? ") ; 

scanf ("*/,d" , &age) ; // On demande d'entrer 1'a.ge avec scanf 

printf ("Ah ! Vous avez done */,d ans ! \n\n" , age); 

return ; 
} 



t> [Code web : 992186) 



Quel age avez-vous ? 20 

Ah ! Vous avez done 20 ans ! 



Le programme se met done en pause apres avoir afHche la question « Quel age avez- 
vous? ». Le curseur apparait a l'ecran, vous devez taper un nombre entier (votre age). 
Tapez ensuite sur « Entree » pour valider, et le programme continuera a s'executer. 
Ici, tout ce qu'il fait apres c'est afficher la valeur de la variable age a l'ecran ( « Ah ! 
Vous avez done 20 ans! »). 

Voila, vous avez compris le principe. Grace a la fonction scanf, on peut done commen- 
cer a interagir avec l'utilisateur. 

Notez que rien ne vous empeche de taper autre chose qu'un nombre entier : 

- si vous rentrez un nombre decimal, comme 2.9, il sera automatiquement tronque, 
e'est-a-dire que seule la partie entiere sera conservee. Dans ce cas, c'est le nombre 2 
qui aurait ete stocke dans la variable ; 
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si vous tapez des lettres au hasard (« eeydf »), la variable ne changera pas de valeur. 
Ce qui est bien ici, c'est qu'on avait initialise notre variable a au debut. De ce fait, 
le programme affichera « ans » si <ja n'a pas marche. Si on n'avait pas initialise la 
variable, le programme aurait pu afficher n'importe quoi ! 



En resume 

- Nos ordinateurs possedent plusieurs types de memoire. De la plus rapide a la plus 
lente : les registres, la memoire cache, la memoire vive et le disque dur. 

- Pour « retenir » des informations, notre programme a besoin de stocker des donnees 
dans la memoire. II utilise pour cela la memoire vive 3 . 

- Dans notre code source, les variables sont des donnees stockees temporairement en 
memoire vive. La valeur de ces donnees peut changer au cours du programme. 

- A l'oppose, on parle de constantes pour des donnees stockees en memoire vive. La 
valeur de ces donnees ne peut pas changer. 

- II existe plusieurs types de variables, qui occupent plus ou moins d'espace en memoire. 
Certains types comme int sont prevus pour stocker des nombres entiers, tandis que 
d'autres comme double stockent des nombres decimaux. 

- La fonction scanf permet de demander a l'utilisateur de saisir un nombre. 



3. Les registres et la memoire cache sont aussi utilises pour augmenter les performances, mais cela 
fonctionne automatiquement, nous n'avons pas a nous en preoccuper. 
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Chapitre 



5 



Une bete de calcu 



Je vous I'ai dit dans le chapitre precedent : votre ordinateur n'est en fait qu'une grosse 
machine a calculer. Que vous soyez en train d'ecouter de la musique, regarder un film 
ou jouer a un jeu video, votre ordinateur ne fait que des calculs. 

Ce chapitre va vous apprendre a realiser la plupart des calculs qu'un ordinateur sait faire. 
Nous reutiliserons ce que nous venons tout juste d'apprendre, a savoir les variables. L'idee, 
c'est justement de faire des calculs avec vos variables : ajouter des variables entre elles, les 
multiplier, enregistrer le resultat dans une autre variable, etc. 

Meme si vous n'etes pas fan des mathematiques, ce chapitre vous sera absolument indis- 
pensable. 
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Les calculs de base 

II faut savoir qu'en plus de n'etre qu'une vulgaire calculatrice, votre ordinateur est une 
calculatrice tres basique puisqu'on ne peut faire que des operations tres simples : 

- addition ; 

- soustraction ; 

- multiplication ; 

- division ; 

- modulo 1 . 

Si vous voulez faire des operations plus compliquees (des carres, des puissances, des 
logarithmes et autres joyeusetes) il vous faudra les programmer, c'est-a-dire expliquer 
a l'ordinateur comment les faire. Fort heureusement, nous verrons plus loin dans ce 
chapitre qu'il existe une bibliotheque mathematique livree avec le langage C qui contient 
des fonctions mathematiques toutes pretes. Vous n'aurez done pas a les reecrire, a moins 
que vous souhaitiez volontairement passer un sale quart d'heure (ou que vous soyez prof 
de maths). 

Voyons done l'addition pour commencer. Pour faire une addition, on utilise le signe + 
(sans blague!). Vous devez mettre le resultat de votre calcul dans une variable. On va 
done par exemple creer une variable resultat de type int et faire un calcul : 

int resultat = 0; 
resultat =5+3; 



Pas besoin d'etre un pro du calcul mental pour deviner que la variable resultat 
contiendra la valeur 8 apres execution. Bien sur, rien ne s'affiche a l'ecran avec ce code. 
Si vous voulez voir la valeur de la variable, rajoutez un printf comme vous savez 
maintenant si bien le faire : 



| printf ("5 + 3 = '/.d" , resultat); 
A l'ecran, cela donnera : 



5 + 3 



Voila pour l'addition. Pour les autres operations, e'est la meme chose, seul le signe 
utilise change (voir tab. 5.1). 

Si vous avez deja utilise la calculatrice sur votre ordinateur, vous devriez connaitre ces 
signes. II n'y a pas de difficulte particuliere pour ces operations, a part pour les deux 
dernieres (la division et le modulo). Nous allons done parler un peu plus en detail de 
chacune d'elles. 



1. Je vous expliquerai ce que e'est si vous ne savez pas, pas de panique. 
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Operation 


Signe 


Addition 


+ 


Soustraction 


- 


Multiplication 


* 


Division 


/ 


Modulo 


7. 



Table 5.1 - Signes des operateurs 



La division 



Les divisions fonctionnent normalement sur un ordinateur quand il n'y a pas de reste. 
Par exemple, 6/3 font 2, votre ordinateur vous donnera la reponse juste. Jusque-la 
pas de souci. 

Mais prenons maintenant une division avec reste comme 5 / 2. . . Le resultat devrait 
etre 2.5. Et pourtant ! Regardez ce que fait ce code : 

int resultat = 0; 

resultat =5/2; 

printf ("5 / 2 = '/.d", resultat); 



5/2 




II y a un gros probleme. On a demande 5 / 2, on s'attend a avoir 2.5, et l'ordinateur 
nous dit que ca fait 2 ! 

II y a anguille sous roche. Nos ordinateurs seraient-ils stupides a ce point ? En fait, 
quand il voit les chiffres 5 et 2, votre ordinateur fait une division de nombres entiers 2 . 
Cela veut dire qu'il tronque le resultat, il ne garde que la partie entiere (le 2). 

)\ He mais je sais pourquoi ! C'est parce que resultat est un int ! Si ca avait 
ete un double, il aurait pu stocker un nombre decimal a I'interieur! 



Eh non, ce n'est pas la raison ! Essayez le meme code en transformant juste resultat 
en double, et vous verrez qu'on vous affiche quand meme 2. Parce que les nombres de 
l'operation sont des nombres entiers, l'ordinateur repond par un nombre entier. 

Si on veut que l'ordinateur affiche le bon resultat, il va falloir transformer les nombres 
5 et 2 de l'operation en nombres decimaux, c'est-a-dire ecrire 5.0 et 2.0 (ce sont les 
memes nombres, mais l'ordinateur considere que ce sont des nombres decimaux, done 
il fait une division de nombres decimaux) : 

double resultat = 0; 



2. Aussi appelee « division euclidienne ». 
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resultat = 5.0 / 2.0; 

printf ("5 / 2 = '/.f", resultat); 



5 / 2 = 2.500000 



La, le nombre est correct. Bon : il affiche des tonnes de zeros derriere si ga lui chante, 
mais le resultat reste quand meme correct. 

Cette propriete de la division de nombres entiers est tres importante. II faut que vous 
reteniez que pour un ordinateur : 

-5/2 = 2; 

- 10 / 3 = 3; 
-4/5 = 0. 

C'est un peu surprenant, mais c'est sa fagon de calculer avec des entiers. 

Si vous voulez avoir un resultat decimal, il faut que les nombres de l'operation soient 
decimaux : 

- 5.0 / 2.0 = 2.5; 

- 10.0 / 3.0 = 3.33333; 

- 4.0 / 5.0 = 0.8. 

En fait, en faisant une division d'entiers comme 5/2, votre ordinateur repond a la 
question « Combien y a-t-il de fois 2 dans le nombre 5 ? ». La reponse est deux fois. 
De meme, « combien de fois y a-t-il le nombre 3 dans 10? » Trois fois. 

Mais alors me direz-vous, comment on fait pour recuperer le reste de la division ? C'est 
la que super-modulo intervient. 

Le modulo 

Le modulo est une operation mathematique qui permet d'obtenir le reste d'une divi- 
sion. C'est peut-etre une operation moins connue que les quatre autres, mais pour votre 
ordinateur ga reste une operation de base. . . probablement pour justement combler le 
probleme de la « division d'entiers » qu'on vient de voir. 

Le modulo, je vous l'ai dit tout a l'heure, se represente par le signe '/,. Voici quelques 
exemples de modulos : 

- 5 % 2 = 1 ; 

- 14 % 3 = 2 ; 

- 4 % 2 = 0. 

Le modulo 5 '/, 2 est le reste de la division 5/2, c'est-a-dire 1. L'ordinateur calcule 
que 5 = 2*2 + 1 (c'est ce 1, le reste, que le modulo renvoie). 

De meme, 14 '/, 3, le calcul est 14 = 3 * 4 + 2 (modulo renvoie le 2). Enfin, pour 4 
'/, 2, la division tombe juste, il n'y a pas de reste, done modulo renvoie 0. 

Voila, il n'y a rien a ajouter au sujet des modulos. Je tenais juste a l'expliquer a ceux 
qui ne connaitraient pas. 
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En plus j'ai une bonne nouvelle : on a vu toutes les operations de base. Finis les cours 
de maths ! 



Des calculs entre variables 

Ce qui serait interessant, maintenant que vous savez faire les cinq operations de base, 
ce serait de s'entrainer a faire des calculs entre plusieurs variables. En effet, rien ne 
vous empeche de faire : 

I resultat = nombrel + nombre2; 

Cette ligne fait la somme des variables nombrel et nombre2, et stocke le resultat dans 
la variable resultat. 

Et c'est la que les choses commencent a devenir tres interessantes. Tenez, il me vient 
une idee. Vous avez maintenant deja le niveau pour realiser une mini-calculatrice. Si, 
si, je vous assure! 

Imaginez un programme qui demande deux nombres a l'utilisateur. Ces deux nombres, 
vous les stockez dans des variables. Ensuite, vous faites la somme de ces variables et 
vous stockez le resultat dans une variable appelee resultat. Vous n'avez plus qu'a 
affkher le resultat du calcul a l'ecran, sous les yeux ebahis de l'utilisateur qui n'aurait 
jamais ete capable de calculer cela de tete aussi vite. 

Essayez de coder vous-memes ce petit programme, c'est facile et <ja vous entrainera ! 

La reponse est ci-dessous : 



int main(int argc, char *argv[]) 
{ 

int resultat = 0, nombrel = 0, nombre2 = 0; 

// On demande les nombres 1 et 2 a l'utilisateur : 

printf ("Entrez le nombre 1 : "); 
scanf ("*/,d" , ftnombrel) ; 
printf ("Entrez le nombre 2 : "); 
scanf ("*/,d" , &nombre2) ; 

// On fait le calcul : 

resultat = nombrel + nombre 2; 

// Et on affiche 1' addition a l'ecran : 

printf ("*/,d + '/,d = '/,d\n" , nombrel, nombre2, resultat); 

return 0; 
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> Code web : 256452 



Entrez le nombre 1 


30 


Entrez le nombre 2 


25 


30 + 25 = 55 





Sans en avoir l'air, on vient de faire la notre premier programme ayant un interet. 
Notre programme est capable d'additionner deux nombres et d'afficher le resultat de 
l'operation ! 

Vous pouvez essayer avec n'importe quel nombre (du moment que vous ne depassez 
pas les limites d'un type int), votre ordinateur effectuera le calcul en un eclair 3 . 

Je vous conseille de faire la meme chose avec les autres operations pour vous entrainer 
(soustraction, multiplication...). Vous ne devriez pas avoir trop de mal vu qu'il y a 
juste un ou deux signes a changer. Vous pouvez aussi ajouter une troisieme variable et 
faire l'addition de trois variables a la fois, <ja fonctionne sans probleme : 

I resultat = nombrel + nombre2 + nombre3; 

Les raccourcis 

Comme promis, nous n'avons pas de nouvelles operations a voir. Et pour cause ! Nous 
les connaissons deja toutes. C'est avec ces simples operations de base que vous pouvez 
tout creer. II n'y a pas besoin d'autres operations. Je reconnais que c'est difficile a 
avaler, se dire qu'un jeu 3D ne fait rien d'autre au final que des additions et des 
soustractions, pourtant. . . c'est la stricte verite. 

Ceci etant, il existe en C des techniques permettant de raccourcir l'ecriture des ope- 
rations. Pourquoi utiliser des raccourcis? Parce que, souvent, on fait des operations 
repetitives. Vous allez voir ce que je veux dire par la tout de suite, avec ce qu'on 
appelle l'incrementation. 

L'incrementation 

Vous verrez que vous serez souvent amenes a ajouter 1 a une variable. Au fur et a 
mesure du programme, vous aurez des variables qui augmentent de 1 en 1. 

Imaginons que votre variable s'appelle nombre (nom tres original, n'est-ce pas ?). Sauriez- 
vous comment faire pour ajouter 1 a cette variable, sans savoir quel est le nombre qu'elle 
contient ? 

Void comment on doit faire : 
I nombre = nombre + 1 ; 



3. Encore heureux, parce que des operations comme ca, il doit en faire des milliards en une seule 
seconde ! 
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Que se passe-t-il ici? On fait le calcul nombre + 1, et on range ce resultat dans la 
variable. . . nombre ! Du coup, si notre variable nombre valait 4, elle vaut maintenant 5. 
Si elle valait 8, elle vaut maintenant 9, etc. 

Cette operation est justement repetitive. Les informaticiens etant des gens particulie- 
rement faineants, ils n'avaient guere envie de taper deux fois le meme nom de variable 
(ben oui quoi, c'est fatigant!). Ils ont done invente un raccourci pour cette opera- 
tion qu'on appelle l'incrementation. Cette instruction produit exactement le meme 
resultat que le code qu'on vient de voir : 

I nombre++ ; 

Cette ligne, bien plus courte que celle de tout a l'heure, signifie « Ajoute 1 a la variable 
nombre ». II suffit d'ecrire le nom de la variable a incrementer, de mettre deux signes 
+, et bien entendu, de ne pas oublier le point-virgule. 

Mine de rien, cela nous sera bien pratique par la suite car, comme je vous l'ai dit, on 
sera souvent amenes a faire des incrementations (e'est-a-dire ajouter 1 a une variable). 

Si vous etes perspicaces, vous avez d'ailleurs remarque que ce signe ++ 
se trouve dans le nom du langage C++. C'est en fait un clin d'oeil des 
programmeurs, et vous etes maintenant capables de le comprendre! C++ 
signifie qu'il s'agit du langage C « increments », e'est-a-dire si on veut « du 
langage C a un niveau superieur ». En pratique, le C++ permet surtout de 
programmer differemment mais il n'est pas « meilleur » que le C : juste 
different. 




a 



La decrementation 

C'est tout betement l'inverse de l'incrementation : on enleve 1 a une variable. Meme 
si on fait plus souvent des incrementations que des decrementations, cela reste une 
operation pratique que vous utiliserez de temps en temps. 

La decrementation, si on l'ecrit en forme « longue » : 

I nombre = nombre - 1 ; 

Et maintenant en forme « raccourcie » : 

I nombre - - ; 

On l'aurait presque devine tout seul ! Au lieu de mettre un ++, vous mettez un — : si 
votre variable vaut 6, elle vaudra 5 apres l'instruction de decrementation. 

Les autres raccourcis 

II existe d'autres raccourcis qui fonctionnent sur le meme principe. Cette fois, ces 
raccourcis fonctionnent pour toutes les operations de base :+-*/'/.. 
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Cela permet la encore d'eviter une repetition du nom d'une variable sur une meme 
ligne. Ainsi, si vous voulez multiplier par deux une variable : 

I nombre = nombre * 2 ; 

Vous pouvez l'ecrire d'une fagon raccourcie comme ceci : 

I nombre *= 2; 

Si le nombre vaut 5 au depart, il vaudra 10 apres cette instruction. Pour les autres 
operations de base, cela fonctionne de la meme maniere. Voici un petit programme 
d'exemple : 

int nombre = 2; 

nombre += 4 ; // nombre vaut 6 . . . 

nombre -= 3; // ... nombre vaut maintenant 3 

nombre *= 5; // ... nombre vaut 15 

nombre /= 3 ; // ... nombre vaut 5 

nombre '/,= 3; // ... nombre vaut 2 (car 5 = 1*3 + 2) 

(Ne boudez pas, un peu de calcul mental n'a jamais tue personne !) 

L'avantage ici est qu'on peut utiliser toutes les operations de base, et qu'on peut ajou- 
ter, soustraire, multiplier par n'importe quel nombre. Ce sont des raccourcis a connaitre 
si vous avez un jour des lignes repetitives a taper dans un programme. 

Retenez quand meme que l'incrementation reste de loin le raccourci le plus utilise. 

La bibliotheque mathematique 

En langage C, il existe ce qu'on appelle des bibliotheques « standard », c'est-a-dire 
des bibliotheques toujours utilisables. Ce sont en quelque sorte des bibliotheques « de 
base » qu'on utilise tres souvent. 

Les bibliotheques sont, je vous le rappelle, des ensembles de fonctions toutes pretes. 
Ces fonctions ont ete ecrites par des programmeurs avant vous, elles vous evitent en 
quelque sorte d'avoir a reinventer la roue a chaque nouveau programme. 

Vous avez deja utilise les fonctions printf et scanf de la bibliotheque stdio.h. II faut 
savoir qu'il existe une autre bibliotheque, appelee math.h, qui contient de nombreuses 
fonctions mathematiques toutes pretes. 

En effet, les cinq operations de base que l'on a vues sont loin d'etre suffisantes ! Bon, 
il se peut que vous n'ayez jamais besoin de certaines operations complexes comme 
les exponentielles 4 . Toutefois, la bibliotheque mathematique contient de nombreuses 
autres fonctions dont vous aurez tres probablement besoin. 



4. Si vous ne savez pas ce que c'est, c'est que vous etes peut-etre un peu trop jeunes ou que vous 
n'avez pas assez fait de maths dans votre vie. 
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Tenez par exemple, on ne peut pas faire de puissances en C ! Comment calculer un 
simple carre ? Vous pouvez toujours essayer de taper 5 2 dans votre programme, mais 
votre ordinateur ne le comprendra jamais car il ne sait pas ce que c'est. . . A moins que 
vous le lui expliquiez en lui indiquant la bibliotheque mathematique ! 

Pour pouvoir utiliser les fonctions de la bibliotheque mathematique, il est indispensable 
de mettre la directive de preprocesseur suivante en haut de votre programme : 

I # include <math.h> 

Une fois que c'est fait, vous pouvez utiliser toutes les fonctions de cette bibliotheque. 

J'ai justement l'intention de vous les presenter. Bon : comme il y a beaucoup de fonc- 
tions, je ne peux pas en faire la liste complete ici. D'une part ca vous ferait trop 
a assimiler, et d'autre part mes pauvres petits doigts auraient fondu avant la fin de 
l'ecriture du chapitre. Je vais done me contenter des fonctions principales, e'est-a-dire 
celles qui me semblent les plus importantes. 

Vous n'avez peut-etre pas tous le niveau en maths pour comprendre ce que 
font ces fonctions. Si c'est votre cas, pas d'inquietude. Lisez juste, cela ne 
vous penalisera pas pour la suite. Ceci etant, je vous offre un petit conseil 
gratuit : soyez attentifs en cours de maths, on ne dirait pas comme ca, mais 
en fait ca finit par servir I 
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fabs 

Cette fonction retourne la valeur absolue d'un nombre, e'est-a-dire |x| (c'est la notation 
mathematique). La valeur absolue d'un nombre est sa valeur positive : 

- si vous donnez -53 a la fonction, elle vous renvoie 53 ; 

- si vous donnez 53 a la fonction, elle vous renvoie 53. 

En bref, elle renvoie toujours l'equivalent positif du nombre que vous lui donnez. 

double absolu = 0, nombre = -27; 

absolu = fabs (nombre) ; // absolu vaudra 27 

Cette fonction renvoie un double, done votre variable absolu doit etre de type double. 

II existe aussi une fonction similaire appelee abs, situee cette fois dans 
stdlib.h. La fonction abs marche de la meme maniere, sauf qu'elle uti- 
lise des entiers (int). Elle renvoie done un nombre entier de type int et non 
un double comme fabs. 
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ceil 

Cette fonction renvoie le premier nombre entier apres le nombre decimal qu'on lui 
donne. C'est une sorte d'arrondi. On arrondit en fait toujours au nombre entier supe- 
rieur. Par exemple, si on lui donne 26.512, la fonction renvoie 27. 

Cette fonction s'utilise de la meme maniere et renvoie un double : 

double dessus = 0, nombre = 52.71; 

dessus = ceil (nombre) ; // dessus vaudra 53 



floor 

C'est l'inverse de la fonction precedente : cette fois, elle renvoie le nombre directement 
en dessous. Si vous lui donnez 37.91, la fonction floor vous renverra done 37. 



pow 

Cette fonction permet de calculer la puissance d'un nombre. Vous devez lui indiquer 
deux valeurs : le nombre et la puissance a laquelle vous voulez l'elever. Voici le schema 
de la fonction : 

lpow(nombre, puissance); 

Par exemple, « 2 puissance 3 » (que l'on ecrit habituellement 2 "3 sur un ordinateur), 
c'est le calcul 2 * 2 * 2, ce qui fait 8 : 

double resultat = 0, nombre = 2; 

resultat = pow(nombre, 3); // resultat vaudra 2~3 = 8 

Vous pouvez done utiliser cette fonction pour calculer des carres. II suffit d'indiquer 
une puissance de 2. 

sqrt 

Cette fonction calcule la racine carree d'un nombre. Elle renvoie un double. 

double resultat = 0, nombre = 100; 

resultat = sqrt (nombre) ; // resultat vaudra 10 
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sin, cos, tan 



Ce sont les trois fameuses fonctions utilisees en trigonometrie. Le fonctionnement est 
le meme, ces fonctions renvoient un double. 

Ces fonctions attendent une valeur en radians. 

asin, acos, atan 

Ce sont les fonctions arc sinus, arc cosinus et arc tangente, d'autres fonctions de trigo- 
nometrie. Elles s'utilisent de la meme maniere et renvoient un double. 



exp 

Cette fonction calcule l'exponentielle d'un nombre. Elle renvoie un double (oui, oui, 
elle aussi). 



log 

Cette fonction calcule le logarithme neperien d'un nombre (que l'on note aussi « In »). 

log 10 

Cette fonction calcule le logarithme base 10 d'un nombre. 

En resume 

- Un ordinateur n'est en fait qu'une calculatrice geante : tout ce qu'il sait faire, ce 
sont des operations. 

- Les operations connues par votre ordinateur sont tres basiques : l'addition, la sous- 
traction, la multiplication, la division et le modulo 5 . 

II est possible d'effectuer des calculs entre des variables. C'est d'ailleurs ce 
qu'un ordinateur sait faire de mieux : il le fait bien et vite. 

- L' increment at ion est l'operation qui consiste a ajouter 1 a une variable. On ecrit 
variable++. 

- La decrementation est l'operation inverse : on retire 1 a une variable. On ecrit 
done variable--. 

- Pour augmenter le nombre d'operations connues par votre ordinateur, il faut charger 
la bibliotheque mathematique 6 . 

- Cette bibliotheque contient des fonctions mathematiques plus avancees, telles 
que la puissance, la racine carree, l'arrondi, l'exponentielle, le logarithme, etc. 



5. II s'agit du reste de la division. 

6. #include <math.h> 
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Chapitre 



6 



Les conditions 



Difficulty : 



ous avons vu dans le premier chapitre qu'il existait de nombreux langages de pro- 
grammation. Certains se ressemblent d'ailleurs : un grand nombre d'entre eux sont 
inspires du langage C. 

En fait le langage C a ete cree il y a assez longtemps, ce qui fait qu'il a servi de modele a de 
nombreux autres plus recents. La plupart des langages de programmation ont finalement 
des ressemblances, ils reprennent les principes de base de leurs atnes. 

En parlant de principes de base : nous sommes en plein dedans. Nous avons vu comment 
creer des variables, faire des calculs avec (concept commun a tous les langages de pro- 
grammation I), nous allons maintenant nous interesser aux conditions. Sans conditions, 
nos programmes informatiques feraient toujours la meme chose I 
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La condition if 



else 



Les conditions permettent de tester des variables. On peut par exemple dire « si la 
variable machin est egale a 50, fais ceci » . . . Mais ce serait dommage de ne pouvoir 
tester que l'egalite ! II faudrait aussi pouvoir tester si la variable est inferieure a 50, 
inferieure ou egale a 50, superieure, superieure ou egale. . . Ne vous inquietez pas, le C 
a tout prevu ! 

Pour etudier les conditions if . . . else, nous allons suivre le plan suivant : 

1. quelques symboles a connaitre avant de commencer, 

2. le test if, 

3. le test else, 

4. le test else if, 

5. plusieurs conditions a la fois, 

6. quelques erreurs courantes a eviter. 

Avant de voir comment on ecrit une condition de type if . . . else en C, il faut done 
que vous connaissiez deux ou trois symboles de base. Ces symboles sont indispensables 
pour realiser des conditions. 

Quelques symboles a connaitre 

Voici un petit tableau de symboles du langage C a connaitre par coeur : 



Symbole 


Signification 


== 


est egal a 


> 


est superieur a 


< 


est inferieur a 


>= 


est superieur ou egal a 


<= 


est inferieur ou egal a 


! = 


est different de 



© 



Faites tres attention, il y a bien deux symboles == pour tester l'egalite. Une 
erreur courante que font les debutants et de ne mettre qu'un symbole =, ce 
qui n'a pas la meme signification en C. Je vous en reparlerai un peu plus bas. 



Un if simple 

Attaquons maintenant sans plus tarder. Nous allons faire un test simple, qui va dire a 
l'ordinateur : 

SI la variable vaut <ja, 
ALORS fais ccci. 
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En anglais, le mot « si » se traduit par if. C'est celui qu'on utilise en langage C 
pour introduire une condition. Ecrivez done un if. Ouvrez ensuite des parentheses : a 
l'interieur de ces parentheses vous devrez ecrire votre condition. 

Ensuite, ouvrez une accolade { et fermez-la un peu plus loin }•. Tout ce qui se trouve 
a l'interieur des accolades sera execute uniquement si la condition est verifiee. 

Cela nous donne done a ecrire : 

if (/* Votre condition */) 
{ 

// Instructions a executer si la condition est vraie 
} 

A la place de mon commentaire « Votre condition », on va ecrire une condition pour 
tester une variable. Par exemple, on pourrait tester une variable age qui contient votre 
age. Tenez pour s'entrainer, on va tester si vous etes majeur, e'est-a-dire si votre age 
est superieur ou egal a 18 : 

if (age >= 18) 
{ 

printf ("Vous etes majeur !"); 
} 

Le symbole >= signifie « superieur ou egal », comme on l'a vu dans le tableau tout a 
l'heure. 

S'il n'y a qu'une instruction entre les accolades (comme c'est le cas ici), 
alors celles-ci deviennent facultatives. Je recommande neanmoins de toujours 
mettre des accolades pour des raisons de clarte. 
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Tester ce code 

Si vous voulez tester les codes precedents pour voir comment le if fonctionne, il faudra 
placer le if a l'interieur d'une fonction main et ne pas oublier de declarer une variable 
age a laquelle on donnera la valeur de notre choix. 

Cela peut paraitre evident pour certains, mais plusieurs lecteurs visiblement perdus 
m'ont encourage a ajouter cette explication. Voici done un code complet que vous 
pouvez tester : 

#include <stdio.h> 
#include <stdlib.h> 

int main(int argc, char *argv[]) 
{ 

int age = 20 ; 
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if (age >= 18) 
{ 

printf ("Vous etes majeur !\n"); 
} 

return 0; 



} 



t> ( Code web : 533746 ) 

Ici, la variable age vaut 20, done le « Vous etes majeur ! » s'affichera. Essayez de 
changer la valeur initiale de la variable pour voir. Mettez par exemple 15 : la condition 
sera fausse, et done « Vous etes majeur ! » ne s'affichera pas cette fois. 

Utilisez ce code de base pour tester les prochains exemples du chapitre. 

Une question de proprete 

La fagon dont vous ouvrez les accolades n'est pas importante, votre programme fonc- 
tionnera aussi bien si vous ecrivez tout sur une meme ligne. Par exemple : 

I if (age >= 18) { printf ("Vous etes majeur !"); } 

Pourtant, meme s'il est possible d'ecrire comme <ja, e'est absolument deconseille. 
En effet, tout ecrire sur une meme ligne rend votre code difficilement lisible. Si vous ne 
prenez pas des maintenant l'habitude d'aerer votre code, plus tard quand vous ecrirez 
de plus gros programmes vous ne vous y retrouverez plus ! 

Essayez done de presenter votre code source de la meme fagon que moi : une accolade 
sur une ligne, puis vos instructions (precedees d'une tabulation pour les « decaler vers 
la droite »), puis l'accolade de fermeture sur une ligne. 

II existe plusieurs bonnes facons de presenter son code source. Ca ne change 
rien au fonctionnement du programme final, mais e'est une question de « style 
informatique » si vous voulez. Si vous voyez le code de quelqu'un d'autre 
presente un peu differemment, e'est qu'il code avec un style different. Le 
principal dans tous les cas etant que le code reste aere et lisible. 
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Le else pour dire « sinon » 

Maintenant que nous savons faire un test simple, allons un peu plus loin : si le test n'a 
pas marche (il est faux), on va dire a l'ordinateur d'executer d'autres instructions. 

En frangais, nous allons done ecrire quelque chose qui ressemble a cela : 
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SI la variable vaut ga, 
ALORS fais ceci, 
SINON fais cela. 

II suffit de rajouter le mot else apres l'accolade fermante du if. Petit exemple : 

if (age >= 18) // Si 1'a.ge est superieur ou egal a 18 
{ 

printf ("Vous etes majeur !"); 
} 

else // Sinon. . . 
{ 

printf ("Ah c'est bete, vous etes mineur !"); 
} 

Les choses sont assez simples : si la variable age est superieure ou egale a 18, on affiche 
le message « Vous etes majeur ! », sinon on affiche « Vous etes mineur ». 

Le else if pour dire « sinon si » 

On a vu comment faire un « si » et un « sinon ». II est possible aussi de faire un « sinon 
si » pour faire un autre test si le premier test n'a pas marche. Le « sinon si » se place 
entre le if et le else. 

On dit dans ce cas a l'ordinateur : 

SI la variable vaut ga ALORS fais ccci, 
SINON SI la variable vaut ca ALORS fais ca, 
SINON fais cela. 

Traduction en langage C : 

if (age >= 18) // Si 1'a.ge est superieur ou egal a 18 
{ 

printf ("Vous etes majeur !"); 
} 

else if ( age > 4 ) // Sinon, si l'age est au moins superieur a 4 
{ 

printf ("Bon t'es pas trop jeune quand meme..."); 
} 

else // Sinon. . . 
{ 

printf ("Aga gaa aga gaaa") ; // Langage bebe, vous pouvez pas comprendre 
} 

L'ordinateur fait les tests dans l'ordre. 

1. D'abord il teste le premier if : si la condition est vraie, alors il execute ce qui se 
trouve entre les premieres accolades. 
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2. Sinon, il va au « sinon si » et fait a nouveau un test : si ce test est vrai, alors il 
execute les instructions correspondantes entre accolades. 

3. Enfin, si aucun des tests precedents n'a marche, il execute les instructions du 
« sinon ». 



Le else et le else if ne sont pas obligatoires. Pour faire une condition, seul 
un if est necessaire (logique me direz-vous, sinon il n'y a pas de condition !). 



Notez qu'on peut mettre autant de else if que l'on veut. On peut done ecrire : 

SI la variable vaut <ja, 
ALORS fais ceci, 

SINON SI la variable vaut ca ALORS fais ca, 
SINON SI la variable vaut ca ALORS fais ca, 
SINON SI la variable vaut ca ALORS fais ca, 
SINON fais cela. 



Plusieurs conditions a la fois 

II peut aussi etre utile de faire plusieurs tests a la fois dans votre if. Par exemple, vous 
voudriez tester si Page est superieur a 18 ET si Page est inferieur a 25. Pour faire cela, 
il va falloir utiliser de nouveaux symboles : 



Symbole 


Signification 


&& 


ET 


II 


OU 


j 


NON 



Test ET 

Si on veut faire le test que j'ai mentionne plus haut, il faudra ecrire : 

| if (age > 18 kk age < 25) 

Les deux symboles && signifient ET. Notre condition se dirait en frangais : « si Page 
est superieur a 18 ET si Page est inferieur a 25 ». 

Test OU 

Pour faire un OU, on utilise les deux signes I I . Je dois avouer que ce signe n'est pas 
facilement accessible sur nos claviers. Pour le taper sur un clavier AZERTY frangais, 
il faudra faire Alt Gr + 6. Sur un clavier beige, il faudra faire Alt Gr + &. 
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Imaginons pour l'exemple un programme stupide qui decide si une personne a le droit 
d'ouvrir un compte en banque. C'est bien connu, pour ouvrir un compte en banque il 
vaut mieux ne pas etre trop jeune (on va dire arbitrairement qu'il faut avoir au moins 
30 ans) ou bien avoir beaucoup d'argent (parce que la, meme a 10 ans on vous acceptera 
a bras ouverts!). Notre test pour savoir si le client a le droit d'ouvrir un compte en 
banque pourrait etre : 

if (age > 30 I I argent > 100000) 
{ 

printf ("Bienvenue chez PicsouBanque !"); 
} 

else 
{ 

printf ("Hors de ma vue, miserable !"); 
} 

Ce test n'est valide que si la personne a plus de 30 ans ou si elle possede plus de 100 000 
euros ! 



Test NON 

Le dernier symbole qu'il nous reste a tester est le point d'exclamation. En informatique, 
le point d'exclamation signifie « non ». Vous devez mettre ce signe avant votre condition 
pour dire « si cela n'est pas vrai » : 

| if (!(age < 18)) 

Cela pourrait se traduire par « si la personne n'est pas mineure ». Si on avait enleve 
le ! devant, cela aurait signifie l'inverse : « si la personne est mineure ». 

Quelques erreurs courantes de debutant 

N'oubliez pas les deux signes == 

Si on veut tester si la personne a tout juste 18 ans, il faudra ecrire : 

if (age == 18) 
{ 

printf ("Vous venez de devenir majeur !"); 
} 

N'oubliez pas de mettre deux signes « egal » dans un if, comme ceci : == 

Si vous ne mettez qu'un seul signe =, alors votre variable prendra la valeur 18 (comme 
on l'a appris dans le chapitre sur les variables). Nous ce qu'on veut faire ici, c'est tester 
la valeur de la variable, non pas la changer ! Faites tres attention a cela, beaucoup 
d'entre vous n'en mettent qu'un quand ils debutent et forcement. . . leur programme ne 
fonctionne pas comme ils voudraient ! 
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Le point-virgule de trop 

Une autre erreur courante de debutant : vous mettez parfois un point-virgule a la fin 
de la ligne d'un if. Or, un if est une condition, et on ne met de point-virgule qu'a la 
fin d'une instruction et non d'une condition. Le code suivant ne marchera pas comme 
prevu car il y a un point-virgule a la fin du if : 

if (age == 18) ; // Notez le point-virgule ici qui ne devrait PAS etre la 
{ 

printf ("Tu es tout juste majeur") ; 
} 



Les booleens, le coeur des conditions 

Nous allons maintenant entrer plus en details dans le fonctionnement d'une condition 
de type if . . . else. En effet, les conditions font intervenir quelque chose qu'on appelle 
les booleens en informatique. 

Quelques petits tests pour bien comprendre 

Nous allons commencer par faire quelques petites experiences avant d'introduire cette 
nouvelle notion. Void un code source tres simple que je vous propose de tester : 

if (1) 
{ 

printf ("C'est vrai"); 
} 

else 
{ 

printf ("C'est faux"); 
} 

Result at : 
C'est vrai I 



)\ Mais? On n'a pas mis de condition dans le if, juste un nombre. Qu'est-ce 
que ca veut dire? Ca n'a pas de sens. 



Si, <ja en a, vous allez comprendre. Faites un autre test en remplacant 1 par : 

if (0) 
{ 

printf ("C'est vrai"); 
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} 

else 

{ 

printf ("C'est faux"); 
} 

Resultat : 



C'est faux 



Faites maintenant d'autres tests en remplagant le par n'importe quel autre nombre 
entier, comme 4, 15, 226, -10, -36, etc. Qu'est-ce qu'on vous repond a chaque fois? On 
vous repond : « C'est vrai ». 

Resume de nos tests : si on met un 0, le test est considere comme faux, et si on met 
un 1 ou n'importe quel autre nombre, le test est vrai. 

Des explications s'imposent 

En fait, a chaque fois que vous faites un test dans un if, ce test renvoie la valeur 1 s'il 
est vrai, et s'il est faux. 

Par exemple : 
| if (age >= 18) 

Ici, le test que vous faites est age >= 18. 

Supposons que age vaille 23. Alors le test est vrai, et l'ordinateur « remplace » en 
quelque sorte age >= 18 par 1. Ensuite, l'ordinateur obtient (dans sa tete) un if (1). 
Quand le nombre est 1, comme on l'a vu, l'ordinateur dit que la condition est vraie, 
done il affiche « C'est vrai » ! 

De meme, si la condition est fausse, il remplace age >= 18 par le nombre 0, et du coup 
la condition est fausse : l'ordinateur va lire les instructions du else. 

Un test avec une variable 

Testez maintenant un autre true : envoyez le resultat de votre condition dans une 
variable, comme si e'etait une operation (car pour l'ordinateur, c'est une operation!). 

int age = 20 ; 

int ma j eur = ; 

majeur = age >= 18; 

printf ("Maj eur vaut : '/,d\n" , majeur); 

Comme vous le voyez, la condition age >= 18 a renvoye le nombre 1 car elle est vraie. 
Du coup, notre variable majeur vaut 1, on verifie d'ailleurs cela grace a un printf qui 
montre bien qu'elle a change de valeur. 
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Faites le meme test en mettant age == 10 par exemple. Cette fois, majeur vaudra 0. 

Cette variable majeur est un booleen 

Retenez bien ceci : on dit qu'une variable a laquelle on fait prendre les valeurs et 1 
est un booleen. 

Et aussi ceci : 

- = faux, 

- 1 = vrai. 1 

En langage C, il n'existe pas de type de variable « booleen ». En fait, le type booleen 
n'a ete ajoute qu'en CH — \-. En effet, en CH — \- vous avez un nouveau type bool qui a 
ete cree specialement pour ces variables booleennes. 

Comme ici on fait du C, on ne dispose pas de type special. Du coup, on est oblige 
d'utiliser un type entier comme int pour gerer les booleens. 

Les booleens dans les conditions 

Souvent, on fera un test if sur une variable booleenne : 
int ma j eur = 1 ; 

if (majeur) 
{ 

printf("Tu es majeur !"); 
} 

else 
{ 

printf("Tu es mineur") ; 
} 

Comme majeur vaut 1, la condition est vraie, done on affiche « Tu es majeur! ». 

Ce qui est tres pratique, e'est que la condition peut etre lue facilement par un gtre 
humain. On voit if (majeur), ce qui peut se traduire par « si tu es majeur ». Les 
tests sur des booleens sont done faciles a lire et a comprendre, pour peu que vous ayez 
donne des noms clairs a vos variables comme je vous ai dit de le faire des le debut. 

Tenez, voici un autre test imaginaire : 

I if (majeur && garcon) 

Ce test signifie « si tu es majeur ET que tu es un gargon ». garcon est ici une autre 
variable booleenne qui vaut 1 si vous etes un gargon, et si vous etes. . . une fille! 
Bravo, vous avez tout compris ! 



1. Pour etre tout a fait exact, = faux et tous les autres nombres valent vrai (on a eu l'occasion de 
le tester plus t6t). Ceci dit, pour simplifier les choses on va se contenter de n'utiliser que les nombres 
et 1, pour dire si « quelque chose est faux ou vrai ». 
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Les booleens permettent done de dire si quelque chose est vrai ou faux. C'est vraiment 
utile et ce que je viens de vous expliquer vous permettra de comprendre bon nombre 
de choses par la suite. 



Petite question : si on fait le test if (majeur == 1), ca marche aussi, non ? 



Tout a fait. Mais le principe des booleens c'est justement de raccourcir l'expression du 
if et de la rendre plus facilement lisible. Avouez que if (majeur) ga se comprend tres 
bien, non ? 

Retenez done : si votre variable est censee contenir un nombre (comme un age), faites 
un test sous la forme if (variable == 1). Si au contraire votre variable est censee 
contenir un booleen (e'est-a-dire soit 1 soit pour dire vrai ou faux), faites un test 
sous la forme if (variable) . 



La condition switch 

La condition if . . . else que l'on vient de voir est le type de condition le plus souvent 
utilise. En fait, il n'y a pas 36 fagons de faire une condition en C. Le if . . . else 
permet de gerer tous les cas. 

Toutefois, le if . . . else peut s'averer quelque peu. . . repetitif. Prenons cet exemple : 

if (age == 2) 
{ 

printf ("Salut bebe !"); 
} 

else if (age == 6) 
{ 

printf ("Salut gamin !"); 
} 

else if (age == 12) 
{ 

printf ("Salut jeune !"); 
} 

else if (age == 16) 
{ 

printf ("Salut ado !"); 
} 

else if (age == 18) 
{ 

printf ("Salut adulte !"); 
} 

else if (age == 68) 
{ 

printf ("Salut papy !"); 

87 



CHAPITRE 6. LES CONDITIONS 



} 

else 

{ 

printf("Je n'ai aucune phrase de prete pour ton age"); 
} 



> ( Code web : 964813 ) 

Construire un switch 

Les informaticiens detestent faire des choses repetitives, on a eu l'occasion de le verifier 
plus tot. 

Alors, pour eviter d'avoir a faire des repetitions comme ga quand on teste la valeur 
d'une seule et meme variable, ils ont invente une autre structure que le if . . . else. 
Cette structure particuliere s'appelle switch. Voici un switch base sur l'exemple qu'on 
vient de voir : 

switch (age) 

{ 

case 2: 

printf ("Salut bebe !") ; 

break; 
case 6: 

printf ("Salut gamin !"); 

break; 
case 12: 

printf ("Salut jeune !"); 

break; 
case 16: 

printf ("Salut ado !"); 

break; 
case 18: 

printf ("Salut adulte !"); 

break; 
case 68: 

printf ("Salut papy !"); 

break; 
default : 

printf ("Je n'ai aucune phrase de prete pour ton age ") ; 

break; 
} 

D> ( Code web : 996988 ) 

Impregnez-vous de mon exemple pour creer vos propres switch. On les utilise plus 
rarement, mais c'est vrai que c'est pratique car ga fait (un peu) moins de code a taper. 

L'idee c'est done d'ecrire switch (maVariable) pour dire « je vais tester la valeur de 



LA CONDITION SWITCH 



la variable maVariable ». Vous ouvrez ensuite des accolades que vous refermez tout en 
bas. 

Ensuite, a l'interieur de ces accolades, vous gerez tous les cas : case 2, case 4, case 
5, case 45. . . 
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Vous devez mettre une instruction break; obligatoirement a la fin de chaque 
cas. Si vous ne lefaites pas, alors I'ordinateur ira lire les instructions en dessous 
censees etre reservees aux autres cas I L'instruction break; commande en fait 
a I'ordinateur de « sortir » des accolades. 



Enfin, le cas default correspond en fait au else qu'on connait bien maintenant. Si la 
variable ne vaut aucune des valeurs precedentes, I'ordinateur ira lire le default. 

Gerer un menu avec un switch 

Le switch est tres souvent utilise pour faire des menus en console. Je crois que le 
moment est venu de pratiquer un peu ! 

Au boulot ! 

En console, pour faire un menu, on fait des printf qui afHchent les differentes options 
possibles. Chaque option est numerotee, et l'utilisateur doit entrer le numero du menu 
qui l'interesse. Voici par exemple ce que la console devra afRcher : 



=== Menu === 

1 . Royal Cheese 

2. Mc Deluxe 

3. Mc Bacon 

4. Big Mac 
Votre choix ? 



Voici votre mission (si vous l'acceptez) : reproduisez ce menu a l'aide de printf 
(facile), ajoutez un scanf pour enregistrer le choix de l'utilisateur dans une variable 
choixMenu, et enfin faites un switch pour dire a l'utilisateur « tu as choisi le menu 
Royal Cheese » par exemple. 

Allez, au travail! 

Correction 

Voici la solution (j'espere que vous l'avez trouvee!) : 

#include <stdio.h> 
#include <stdlib.h> 

int main(int argc, char *argv[]) 
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{ 

int choixMenu; 

printf("=== Menu ===\n\n") ; 
printf("l. Royal Cheese\n") ; 
printf("2. Mc Deluxe\n") ; 
printf("3. Mc Bacon\n"); 
printf ("4. Big Mac\n") ; 
printf ("\nVotre choix ? ") ; 
scanf ("*/,d" , ftchoixMenu) ; 

printf ("\n"); 

switch (choixMenu) 
{ 

case 1 : 

printf ("Vous avez choisi le Royal Cheese. Bon choix !"); 
break; 
case 2 : 

printf ("Vous avez choisi le Mc Deluxe. Berk, trop de sauce..."); 
break; 
case 3 : 

printf ("Vous avez choisi le Mc Bacon. Bon, ca passe encore ca ;o)"); 
break; 
case 4: 

printf ("Vous avez choisi le Big Mac. Vous devez avoir tres faim !"); 
break; 
default : 

printf ("Vous n'avez pas rentre un nombre correct. Vous ne mangerez rien 
<->■ du tout !") ; 
break; 
} 

printf ("\n\n") ; 

return ; 



> ( Code web : 534118) 

Et voila le travail ! 

J'espere que vous n'avez pas oublie le default a la fin du switch! En effet, quand 
vous programmez vous devez toujours penser a tous les cas. Vous avez beau dire de 
taper un nombre entre 1 et 4, vous trouverez toujours un imbecile qui ira taper 10 ou 
encore Salut alors que ce n'est pas ce que vous attendez. 

Bref, soyez toujours vigilants de ce cote-ci : ne faites pas confiance a l'utilisateur, il 
peut parfois entrer n'importe quoi. Prevoyez toujours un cas default ou un else si 
vous faites <ja avec des if. 
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LES TERNAIRES : DES CONDITIONS CONDENSEES 

Je vous conseille de vous familiariser avec le fonctionnement des menus en 
console, car on en fait souvent dans des programmes console et vous en aurez 
surement besoin. 



Les ternaires : des conditions condensees 

II existe une troisieme facon de faire des conditions, plus rare. 

On appelle cela des expressions ternaires. Concretement, c'est comme un if . . . 
else, sauf qu'on fait tout tenir sur une seule ligne ! 

Comme un exemple vaut mieux qu'un long discours, je vais vous donner deux fois la 
meme condition : la premiere avec un if . . . else, et la seconde, identique, mais sous 
forme d'une expression ternaire. 

Une condition if . . . else bien connue 

Supposons qu'on ait une variable booleenne majeur qui vaut vrai (1) si on est majeur, 
et faux (0) si on est mineur. On veut changer la valeur de la variable age en fonction 
du booleen, pour mettre "18" si on est majeur, "17" si on est mineur. C'est un exemple 
completement stupide je suis d'accord, mais <ja me permet de vous montrer comment 
on peut se servir des expressions ternaires. 

Voici comment faire cela avec un if . . . else : 

if (majeur) 

age = 18; 
else 

age = 17; 



Notez que j'ai enleve dans cet exemple les accolades car elles sont facultatives 
s'il n'y a qu'une instruction, comme je vous I'ai explique plus tot. 
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La meme condition en ternaire 

Voici un code qui fait exactement la meme chose que le code precedent, mais ecrit cette 
fois sous forme ternaire : 

I age = (majeur) ? 18 : 17; 

Les ternaires permettent, sur une seule ligne, de changer la valeur d'une variable en 
fonction d'une condition. Ici la condition est tout simplement majeur, mais ca pourrait 
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etre n'importe quelle condition plus longue bien entendu 2 . 

Le point d'interrogation permet de dire « est-ce que tu es majeur ? ». Si oui, alors on 
met la valeur 18 dans age. Sinon (le deux-points : signifie else ici), on met la valeur 
17. 

Les ternaires ne sont pas du tout indispensables, personnellement je les utilise peu car 
ils peuvent rendre la lecture d'un code source un peu difficile. Ceci etant, il vaut mieux 
que vous les connaissiez pour le jour ou vous tomberez sur un code plein de ternaires 
dans tous les sens ! 



En resume 

- Les conditions sont a la base de tous les programmes. C'est un moyen pour l'ordi- 
nateur de prendre une decision en fonction de la valeur d'une variable. 

- Les mots-cles if, else if, else signifient respect ivement « si », « sinon si », « si- 
non ». On peut ecrire autant de else if que l'on desire. 

- Un booleen est une variable qui peut avoir deux etats : vrai (1) ou faux (0) 3 . On 
utilise des int pour stocker des booleens car ce ne sont en fait rien d'autre que des 
nombres. 

- Le switch est une alternative au if quand il s'agit d'analyser la valeur d'une variable. 
II permet de rendre un code source plus clair si vous vous appretiez a tester de 
nombreux cas 4 . 

- Les ternaires sont des conditions tres concises qui permettent d'affecter rapide- 
ment une valeur a une variable en fonction du resultat d'un test. On les utilise avec 
parcimonie car le code source a tendance a devenir moins lisible avec elles. 



2. Un autre exemple ? autorisation = (age >= 18)? 1 : 0; 

3. Toute valeur differente de est en fait considered comme « vraie ». 

4. Si vous utilisez de nombreux else if c'est en general le signe qu'un switch serait plus adapte 
pour rendre le code source plus lisible. 
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Les boucles 



Difficulty : BL. 

Apres avoir vu comment realiser des conditions en C, nous allons decouvrir les boucles. 
Qu'est-ce qu'une boucle? C'est une technique permettant de repeter les memes ins- 
tructions plusieurs fois. Cela nous sera bien utile par la suite, notamment pour le 
premier TP qui vous attend apres ce chapitre. 

Relaxez-vous : ce chapitre sera simple. Nous avons vu ce qu'etaient les conditions et les 
booleens dans le chapitre precedent, c'etait un gros morceau a avaler. Maintenant ca va 
couler de source et le TP ne devrait pas vous poser trap de problemes. 

Enfin profitez-en, parce qu'ensuite nous ne tarderons pas a entrer dans la partie II du cours, 
et la vous aurez interet a etre bien reveilles I 
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Qu'est-ce qu'une boucle ? 

Je me repete : une boucle est une structure qui permet de repeter les memes instructions 
plusieurs fois. 

Tout comme pour les conditions, il y a plusieurs facpns de realiser des boucles. Au 
bout du compte, cela revient a faire la meme chose : repeter les memes instructions un 
certain nombre de fois. Nous allons voir trois types de boucles courantes en C : 

- while 

- do . . . while 

- for 



Dans tous les cas, le schema est le meme (fig. 7.1). 



Instructions 
Instructions 
Instructions 
Instructions 
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Figure 7.1 - Schema d'une boucle 
Void ce qu'il se passe dans l'ordre : 

1. l'ordinateur lit les instructions de haut en bas (comme d'habitude) ; 

2. puis, une fois arrive a la fin de la boucle, il repart a la premiere instruction ; 

3. il recommence alors a lire les instructions de haut en bas. . . 

4. . . . et il repart au debut de la boucle. 

Le probleme dans ce systeme c'est que si on ne l'arrete pas, l'ordinateur est capable 
de repeter les instructions a l'infini ! II n'est pas du genre a se plaindre, vous savez : il 
fait ce qu'on lui dit de faire. . . II pourrait tres bien se bloquer dans une boucle infinie, 
c'est d'ailleurs une des nombreuses craintes des programmeurs. 

Et c'est la qu'on retrouve. . . les conditions ! Quand on cree une boucle, on indique 
toujours une condition. Cette condition signifiera « Repete la boucle tant que cette 
condition est vraie ». 

Comme je vous l'ai dit, il y a plusieurs manieres de s'y prendre. Voyons voir sans plus 
tarder comment on realise une boucle de type while en C. 

La boucle while 

Voici comment on construit une boucle while : 

while (/* Condition */) 
{ 
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II Instructions a repeter 
} 



C'est aussi simple que cela. while signifie « Tant que ». On dit done a l'ordinateur 
« Tant que la condition est vraie, repete les instructions entre accolades ». 

Je vous propose de faire un test simple : on va demander a l'utilisateur de taper le 
nombre 47. Tant qu'il n'a pas tape le nombre 47, on lui redemande le nombre. Le 
programme ne pourra s'arreter que si l'utilisateur tape le nombre 47 (je sais, je sais, je 
suis diabolique) : 

int nombreEntre = ; 

while (nombreEntre != 47) 
{ 

printf ("Tapez le nombre 47 ! ") ; 

scanf ("*/,d" , ftnombreEntre) ; 
} 

Voici maintenant le test que j'ai fait. Notez que j'ai fait expres de me tromper 2-3 fois 
avant de taper le bon nombre. 



Tapez le nombre 47 


10 


Tapez le nombre 47 


27 


Tapez le nombre 47 


40 


Tapez le nombre 47 


47 



Le programme s'est arrete apres avoir tape le nombre 47. Cette boucle while se repete 
done tant que l'utilisateur n'a pas tape 47, c'est assez simple. 

Maintenant, essayons de faire quelque chose d'un peu plus interessant : on veut que 
notre boucle se repete un certain nombre de fois. On va pour cela creer une variable 
compteur qui vaudra au debut du programme et que l'on va incrementer au fur et a 
mesure. Vous vous souvenez de l'incrementation ? Ca consiste a ajouter 1 a la variable 
en faisant variable++;. 

Regardez attentivement ce bout de code et, surtout, essayez de le comprendre : 

int compteur = 0; 

while (compteur < 10) 
{ 

printf ("Salut les Zeros !\n"); 

compteur++; 
} 

Resultat : 
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Ce code repete 10 fois l'affichage de « Salut les Zeros ! ». 



Comment ca marche exactement? 



1. Au depart, on a une variable compteur initialisee a 0. Elle vaut done au debut 
du programme. 

2. La boucle while ordonne la repetition TANT QUE compteur est inferieur a 10. 
Comme compteur vaut au depart, on rentre dans la boucle. 

3. On affiche la phrase « Salut les Zeros ! » via un printf . 

4. On incremente la valeur de la variable compteur, grace a compteur++; . compteur 
valait 0, elle vaut maintenant 1. 

5. On arrive a la fin de la boucle (accolade fermante) : on repart done au debut, 
au niveau du while. On refait le test du while : « Est-ce que compteur est 
toujours inferieure a 10 ? ». Ben oui, compteur vaut 1 ! Done on recommence les 
instructions de la boucle. 

Et ainsi de suite. . . compteur va valoir progressivement 0, 1, 2,3,.. ., 8, 9, et 10. Lorsque 
compteur vaut 10, la condition compteur < 10 est fausse. Comme l'instruction est 
fausse, on sort de la boucle. 

On pourrait d'ailleurs voir que la variable compteur augmente au fur et a mesure dans 
la boucle, en l'affichant dans le printf : 



int compteur = 0; 

while (compteur < 10) 
{ 

printf ("La variable compteur vaut '/,d\n" , compteur); 

compteur++; 
} 
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La variable 


compteur 


vaut 





La variable 


compteur 


vaut 


1 


La variable 


compteur 


vaut 


2 


La variable 


compteur 


vaut 


3 


La variable 


compteur 


vaut 


4 


La variable 


compteur 


vaut 


5 


La variable 


compteur 


vaut 


6 


La variable 


compteur 


vaut 


7 


La variable 


compteur 


vaut 


8 


La variable 


compteur 


vaut 
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Voila : si vous avez compris ga, vous avez tout compris ! Vous pouvez vous amuser a 
augmenter la limite du nombre de boucles (< 100 au lieu de < 10). Cela m'aurait ete 
d'ailleurs tres utile plus jeune pour rediger les punitions que je devais reecrire 100 fois. 

Attention aux boucles infinies 

Lorsque vous creez une boucle, assurez-vous toujours qu'elle peut s'arreter a un 

moment ! Si la condition est toujours vraie, votre programme ne s'arretera jamais ! 
Void un exemple de boucle infinie : 

while (1) 
{ 

printf ("Boucle infinie\n"); 
} 

Souvenez-vous des booleens : 1 = vrai, = faux. Ici, la condition est toujours vraie, ce 
programme affichera done « Boucle infinie » sans arret ! 

Pour arreter un tel programme sous Windows, vous n'avez pas d'autre choix 
que de fermer la console en cliquant sur la croix en haut a droite. Sous Linux, 
faites Ctrl + C. 
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Faites done tres attention : evitez a tout prix de tomber dans une boucle infinie. Notez 
toutefois que les boucles infinies peuvent s'averer utiles, notamment, nous le verrons 
plus tard, lorsque nous realiserons des jeux. 



La boucle do . . . while 

Ce type de boucle est tres similaire a while, bien qu'un peu moins utilise en general. 
La seule chose qui change en fait par rapport a while, e'est la position de la condition. 
Au lieu d'etre au debut de la boucle, la condition est a la fin : 

int compteur = 0; 
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do 
{ 

printf ("Salut les Zeros !\n"); 

compteur++; 
} while (compteur < 10) ; 

Qu'est-ce que ga change? C'est tres simple : la boucle while pourrait tres bien ne 
jamais etre executee si la condition est fausse des le depart. Par exemple, si on avait 
initialise le compteur a 50, la condition aurait ete fausse des le debut et on ne serait 
jamais rentre dans la boucle. Pour la boucle do . . . while, c'est different : cette boucle 
s'executera toujours au moins une fois. En effet, le test se fait a la fin comme 
vous pouvez le voir. Si on initialise compteur a 50, la boucle s'executera une fois. 

II est done parfois utile de faire des boucles de ce type, pour s'assurer que l'on rentre 
au moins une fois dans la boucle. 
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II y a une particularity dans la boucle do . . . while qu'on a tendance a oublier 
quand on debute : il y a un point-virgule tout a la fin! N'oubliez pas d'en 
mettre un apres le while, sinon votre programme plantera a la compilation ! 



La boucle for 

En theorie, la boucle while permet de realiser toutes les boucles que l'on veut. Toute- 
fois, tout comme le switch pour les conditions, il est dans certains cas utile d'avoir un 
autre systeme de boucle plus « condense », plus rapide a ecrire. 

Les boucles for sont tres tres utilisees en programmation. Je n'ai pas de statistiques 
sous la main, mais sachez que vous utiliserez certainement autant de for que de while, 
si ce n'est plus, il vous faudra done savoir manipuler ces deux types de boucles. 

Comme je vous le disais, les boucles for sont juste une autre fagon de faire une boucle 
while. Voici un exemple de boucle while que nous avons vu tout a l'heure : 

int compteur = 0; 

while (compteur < 10) 
{ 

printf ("Salut les Zeros !\n"); 

compteur++; 
} 

Voici maintenant l'equivalent en boucle for : 

int compteur; 

for (compteur = ; compteur < 10 ; compteur++) 
{ 
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printf ("Salut les Zeros !\n"); 

Quelles differences ? 

- Vous noterez que l'on n'a pas initialise la variable compteur a des sa declaration 
(mais on aurait pu le faire). 

- II y a beaucoup de choses entre les parentheses apres le for (nous allons detainer ga 
apres). 

- II n'y a plus de compteur++; dans la boucle. 

Interessons-nous a ce qui se trouve entre les parentheses, car c'est la que reside tout 
l'interet de la boucle for. II y a trois instructions condensees, chacune separee par un 
point- virgule. 

- La premiere est l'initialisation : cette premiere instruction est utilisee pour preparer 
notre variable compteur. Dans notre cas, on initialise la variable a 0. 

- La seconde est la condition : comme pour la boucle while, c'est la condition qui 
dit si la boucle doit etre repetee ou non. Tant que la condition est vraie, la boucle 
for continue. 

- Enfin, il y a l'incrementation : cette derniere instruction est executee a la fin dc 
chaque tour de boucle pour mettre a jour la variable compteur. La quasi-totalite 
du temps on fera une incrementation, mais on peut aussi faire une decrementation 
(variable--;) ou encore n'importe quelle autre operation (variable += 2; pour 
avancer de 2 en 2 par exemple). 

Bref, comme vous le voyez la boucle for n'est rien d'autre qu'un condense. Sachez vous 
en servir, vous en aurez besoin plus d'une fois ! 



En resume 

- Les boucles sont des structures qui nous permettent de repeter une serie destruc- 
tions plusieurs fois. 

- II existe plusieurs types de boucles : while, do. . . while ct for. Certaines sont plus 
adaptees que d'autres selon les cas. 

- La boucle for est probablement celle qu'on utilise le plus dans la pratique. On y fait 
tres souvent des incrementations ou des decrementations de variables. 
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TP : Plus ou Moins, votre premier jeu 



Difficulty : 



ous arrivons maintenant dans le premier TP. Le but est de vous montrer que vous 
savez faire des choses avec ce que je vous ai appris. Car en effet, la theorie c'est bien, 
mais si on ne sait pas mettre tout cela en pratique de maniere concrete. . . ca ne sert 
a rien d'avoir passe tout ce temps a apprendre. 

Croyez-le ou non, vous avez deja le niveau pour realiser un premier programme amusant. 
C'est un petit jeu en mode console (les programmes en fenetres arriveront plus tard je vous 
le rappelle). Le principe du jeu est simple et le jeu est facile a programmer. C'est pour cela 
que j'ai choisi d'en faire le premier TP du cours. 
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Preparatifs et conseils 

Le principe du programme 

Avant toute chose, il faut que je vous explique en quoi va consister notre programme. 
C'est un petit jeu que j'appelle « Plus ou moms ». 

Le principe est le suivant. 

1. L'ordinateur tire au sort un nombre entre 1 et 100. 

2. II vous demande de deviner le nombre. Vous entrez done un nombre entre 1 et 
100. 

3. L'ordinateur compare le nombre que vous avez entre avec le nombre « mystere » 
qu'il a tire au sort. II vous dit si le nombre mystere est superieur ou inferieur a 
celui que vous avez entre. 

4. Puis l'ordinateur vous redemande le nombre. 

5. . . . Et il vous indique si le nombre mystere est superieur ou inferieur. 

6. Et ainsi de suite, jusqu'a ce que vous trouviez le nombre mystere. 

Le but du jeu, bien sur, est de trouver le nombre mystere en un minimum de coups. 
Voici une « capture d'ecran » d'une partie, c'est ce que vous devez arriver a faire : 



Quel est le nombre 


•? 


SO 


C'est plus ! 






Quel est le nombre 


•? 


75 


C'est plus ! 






Quel est le nombre 


•? 


85 


C'est moins ! 






Quel est le nombre 


7 


80 


C'est moins ! 






Quel est le nombre 


7 


78 


C'est plus ! 






Quel est le nombre 


7 


79 


Bravo, vous avez trouve le nombre mystere !!! 



Tirer un nombre au sort 

H Mais comment tirer un nombre au hasard ? Je ne sais pas le faire ! 




O 



Certes, nous ne savons pas generer un nombre aleatoire. II faut dire que demander cela 
a l'ordinateur n'est pas simple : il sait bien faire des calculs, mais lui demander de 
choisir un nombre au hasard, ga, il ne sait pas faire ! 

102 



PREPARATIFS ET CONSEILS 



En fait, pour « essayer » d'obtenir un nombre aleatoire, on doit faire faire des calculs 
complexes a l'ordinateur. . . ce qui revient au bout du compte a faire des calculs ! 

Bon, on a done deux solutions. 

- Soit on demande a l'utilisateur d'entrer le nombre mystere via un scanf d'abord. Qa, 
implique qu'il y ait deux joueurs : l'un entre un nombre au hasard et l'autre essaie 
de le deviner ensuite. 

- Soit on tente le tout pour le tout et on essaie quand meme de generer un nombre 
aleatoire automatiquement. L'avantage est qu'on peut jouer tout seul du coup. Le 
defaut. . . est qu'il va falloir que je vous explique comment faire ! 

Nous allons tenter la seconde solution, mais rien ne vous empeche de coder la premiere 
ensuite si vous voulez. 

Pour generer un nombre aleatoire, on utilise la fonction rand(). Cette fonction genere 
un nombre au hasard. Mais nous, on veut que ce nombre soit compris entre 1 et 100 
par exemple (si on ne connait pas les limites, <ja va devenir trop complique). 

Pour ce faire, on va utiliser la formule suivante 1 : 



srand(time(NULL) ) ; 

nombreMystere = (rand() */, (MAX - MIN + 1)) + MIN; 

La premiere ligne (avec srand) permet d'initialiser le generateur de nombres aleatoires. 
Oui, e'est un peu complique, je vous avais prevenus. nombreMystere est une variable 
qui contiendra le nombre tire au hasard. 



A 



L'instruction srand ne doit etre executee qu'une seule fois (au debut du 
programme). II faut obligatoirement faire un srand une fois, et seulement une 
fois. Vous pouvez ensuite faire autant de rand() que vous voulez pour generer 
des nombres aleatoires, mais il ne faut PAS que l'ordinateur lise l'instruction 
srand deux fois par programme, ne I'oubliez pas. 



MAX et MIN sont des constantes, le premier est le nombre maximal (100) et le second 
le nombre minimal (1). Je vous recommande de definir ces constantes au debut du 
programme, comme ceci : 

| const int MAX = 100, MIN = 1; 



Les bibliotheques a inclure 

Pour que votre programme fonctionne correctement, vous aurez besoin d'inclure trois 
bibliotheques : stdlib, stdio et time (la derniere sert pour les nombres aleatoires). 
Votre programme devra done commencer par : 



1. Je ne pouvais pas trop vous demander de la deviner! 
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#include <stdio.h> 
#include <stdlib.h> 
#include <time.h> 



J'en ai assez dit ! 

Bon allez, j'arrete la parce que sinon je vais vous dormer tout le code du programme si 
ca continue ! 

Pour vous faire generer des nombres aleatoires, j'ai ete oblige de vous don- 
ner des codes « tout prets », sans vous expliquer totalement comment ils 
fonctionnent. En general je n'aime pas faire ca mais la, je n'ai pas vraiment 
le choix car ca compliquerait trop les choses pour le moment. Soyez surs 
toutefois que par la suite vous apprendrez de nouvelles notions qui vous per- 
mettront de comprendre cela. 




a 



Bref, vous en savez assez. Je vous ai explique le principe du programme, je vous ai fait 
une capture d'ecran du programme au cours d'une partie. Avec tout ca, vous etes tout 
a fait capables d'ecrire le programme. 

A vous de jouer ! Bonne chance ! 

Correction ! 

Stop ! A partir d'ici je ramasse les copies. 

Je vais vous donner une correction (la mienne), mais il y a plusieurs bonnes facons de 
faire le programme. Si votre code source n'est pas identique au mien et que vous avez 
trouve une autre fagon de le faire, sachez que c'est probablement aussi bien. 

La correction de « Plus ou Moins » 

Voici la correction que je vous propose : 



#include <stdio.h> 
#include <stdlib.h> 
#include <time.h> 

int main ( int argc, char** argv ) 
{ 

int nombreMystere = 0, nombreEntre = 0; 

const int MAX = 100, MIN = 1; 

// Generation du nombre aleatoire 
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srand (time (NULL)) ; 

nombreMystere = (randO '/. (MAX - MIN + 1)) + MIN; 

/* La boucle du programme. Elle se repete tant que l'utilisateur 
n'a pas trouve le nombre mystere */ 

do 
{ 

// On demande le nombre 

printf ("Quel est le nombre ? ") ; 

scanf("'/,d", ftnombreEntre) ; 

// On compare le nombre entre avec le nombre mystere 

if (nombreMystere > nombreEntre) 

printf ("C'est plus !\n\n"); 
else if (nombreMystere < nombreEntre) 

printf ("C'est moins !\n\n"); 
else 

printf ("Bravo, vous avez trouve le nombre mystere !!!\n\n"); 
} while (nombreEntre != nombreMystere); 



> ( Code web : 589660 ) 



Executable et sources 

Pour ceux qui le desirent, je mets a votre disposition en telechargement l'executable 
du programme ainsi que les sources. 

> ( Code web : 175574 ) 

L'executable (exe) est compile pour Windows, done si vous etes sous un autre 
systeme d'exploitation il faudra obligatoirement recompiler le programme 
pour qu'il marche chez vous. 

II y a deux dossiers, l'un avec l'executable (compile sous Windows je le rappelle) et 
l'autre avec les sources. 

Dans le cas de « Plus ou moins », les sources sont tres simples : il y a juste un fichier 
main.c. N'ouvrez pas le fichier main.c directement. Ouvrez d'abord votre IDE favori 
(Code: :Blocks, Visual, etc.) et creez un nouveau projet de type console, vide. Une 
fois que c'est fait, demandez a ajouter au projet le fichier main.c. Vous pourrez alors 
compiler le programme pour tester et le modifier si vous le desirez. 
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Explications 

Je vais maintenant vous expliquer mon code, en commengant par le debut. 

Les directives de preprocesseur 

Ce sont les lignes commengant par # tout en haut. Elles incluent les bibliotheques dont 
on a besoin. Je vous les ai donnees tout a l'heure, done si vous avez reussi a faire une 
erreur la, vous etes tres forts. 

Les variables 

On n'en a pas eu besoin de beaucoup. Juste une pour le nombre entre par l'utilisateur 
(nombreEntre) et une autre qui retient le nombre aleatoire genere par l'ordinateur 

(nombreMystere). 

J'ai aussi defini les constantes comme je vous l'ai dit au debut de ce chapitre. L'avantage 
de definir les constantes en haut du programme, e'est que pour changer la difficulte (en 
mettant 1000 pour MAX par exemple) il suffit juste d'editer cette ligne et de recompiler. 

La boucle 

J'ai choisi de faire une boucle do . . . while. En theorie, une boucle while simple aurait 
pu fonctionner aussi, mais j'ai trouve qu'utiliser do. . . while etait plus logique. 

Pourquoi ? Parce que, souvenez-vous, do . . . while est une boucle qui s'execute au 
moins une fois. Et nous, on sait qu'on veut demander le nombre a l'utilisateur au 
moins une fois (il ne peut pas trouver le resultat en moins d'un coup, ou alors e'est 
qu'il est super fort !). 

A chaque passage dans la boucle, on redemande a l'utilisateur d'entrer un nombre. On 
stocke le nombre qu'il propose dans nombreEntre. Puis, on compare ce nombreEntre 
au nombreMystere. II y a trois possibilites : 

- le nombre mystere est superieur au nombre entre, on indique done l'indice « C'est 
plus ! » ; 

- le nombre mystere est inferieur au nombre entre, on indique l'indice « C'est moins ! » ; 

- et si le nombre mystere n'est ni superieur ni inferieur ? Eh bien. . . c'est qu'il est 
egal, forcement ! D'ou le else. Dans ce cas, on affiche la phrase « Bravo vous avez 
trouve ! ». 

II faut une condition pour la boucle. Celle-ci etait facile a trouver : on continue la 
boucle TANT QUE le nombre entre n'est pas egal au nombre mystere. Quand 
ces deux nombres sont egaux (e'est-a-dire quand on a trouve), la boucle s'arrete. Le 
programme est alors termine. 
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Idees d'amelioration 

Vous ne croyiez tout de meme pas qu'on allait s'arreter la? Je veux vous inciter a 
continuer a ameliorer ce programme, pour vous entrainer. N'oubliez pas que c'est en 
vous entrainant comme cela que vous progresserez ! Ceux qui lisent les cours d'une 
traite sans jamais faire de tests font une grosse erreur, je l'ai dit et je le redirai! 

Figurez-vous que j'ai une imagination debordante, et meme sur un petit programme 
comme celui-la je ne manque pas d'idees pour l'ameliorer! 

Attention : cette fois je ne vous fournis pas de correction, il faudra vous debrouiller 
tout seuls ! Si vous avez vraiment des problemes, n'hesitez pas a aller faire un tour sur 
les forums du Site du Zero, section langage C. Faites une recherche pour voir si on n'a 
pas deja donne la reponse a vos questions, sinon creez un nouveau sujet pour poser ces 
questions. 

> ( Code web : 473573 ) 

- Faites un compteur de « coups » . Ce compteur devra etre une variable que vous 
incrementerez a chaque fois que vous passez dans la boucle. Lorsque l'utilisateur a 
trouve le nombre mystere, vous lui direz « Bravo, vous avez trouve le nombre mystere 
en 8 coups » par exemple. 

- Lorsque l'utilisateur a trouve le nombre mystere, le programme s'arrete. Pourquoi 
ne pas demander s'il veut faire une autre partie ? Si vous faites <ja, il vous faudra 
faire une boucle qui englobera la quasi-totalite de votre programme. Cette boucle 
devra se repeter TANT QUE l'utilisateur n'a pas demande a arreter le programme. 
Je vous conseille de rajouter une variable booleenne continuerPartie initialisee a 1 
au depart. Si l'utilisateur demande a arreter le programme, vous mettrez la variable 
a et le programme s'arretera. 

- Implementez un mode 2 joueurs ! Attention, je veux qu'on ait le choix entre un 
mode 1 joueur et un mode 2 joueurs ! Vous devrez done faire un menu au debut 
de votre programme qui demande a l'utilisateur le mode de jeu qui l'interesse. La 
seule chose qui changera entre les deux modes de jeu, c'est la generation du nombre 
mystere. Dans un cas ce sera un rand() comme on a vu, dans l'autre cas <ja sera. . . 
un scanf . 

- Creez plusieurs niveaux de difflculte. Au debut, faites un menu qui demande le 
niveau de difflculte. Par exemple : 

- 1 = entre 1 et 100 ; 

- 2 = entre 1 et 1000 ; 
3 = entre 1 et 10000. 

Si vous faites <ja, vous devrez changer votre constante MAX. . . Eh oui, ga ne peut 
plus etre une constante si la valeur doit changer au cours du programme ! Renommez 
done cette variable en nombreMaximum (vous prendrez soin d'enlever le mot-cle const 
sinon <ja sera toujours une constante !). La valeur de cette variable dependra du niveau 
qu'on aura choisi. 

Voila, <ja devrait vous occuper un petit bout de temps. Amusez-vous bien et n'hesitez 
pas a chercher d'autres idees pour ameliorer ce « Plus ou Moins », je suis sur qu'il y 
en a ! N'oubliez pas que les forums sont a votre disposition si vous avez des questions. 
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Chapitre 



9 



Les fonctions 



Difficulty : WB 

ous terminerons la partie I du cours (« Les bases ») par cette notion fondamentale 
que sont les fonctions en langage C. Tous les programmes en C se basent sur le 
principe que je vais vous expliquer dans ce chapitre. 

Nous allons apprendre a structurer nos programmes en petits bouts. . . un peu comme si 
on jouait aux Legos. Tous les gros programmes en C sont en fait des assemblages de petits 
bouts de code, et ces petits bouts de code sont justement ce qu'on appelle. . . des fonctions ! 
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Creer et appeler une fonction 

Nous avons vu dans les tout premiers chapitres qu'un programme en C commengait 
par une fonction appelee main. Je vous avais meme fait un schema recapitulatif, pour 
vous rappeler quelques mots de vocabulaire (fig. 9.1). 

#include <stdio.h> I r^. ,. 

nnciude < s tdiib.h>/ Directives de preprocesseur 

itit main ( ) *"\ 

printf (-Bella world !\n");\| nstruct j 0ns Lp or|ct j on 

Figure 9.1 - Le vocabulaire du programme minimal 

En haut, on y trouve les directives de preprocesseur (un nom barbare sur lequel on 
reviendra d'ailleurs). Ces directives sont faciles a identifier : elles commencent par un 
# et sont generalement mises tout en haut des fichiers sources. 

Puis en dessous, il y avait ce que j 'avais deja appele « une fonction ». Ici, sur mon 
schema, vous voyez une fonction main (pas trop remplie il faut le reconnaitre) . 

Je vous avais dit qu'un programme en langage C commengait par la fonction main. Je 
vous rassure, c'est toujours vrai! Seulement, jusqu'ici nous sommes restes a l'interieur 
de la fonction main. Nous n'en sommes jamais sortis. Revoyez vos codes sources et vous 
verrez : nous sommes toujours restes a l'interieur des accolades de la fonction main. 

Eh bien, c'est mal d'avoir fait comme ca ? 

Non ce n'est pas « mal », mais ce n'est pas ce que les programmeurs en C font dans la 
realite. Quasiment aucun programme n'est ecrit uniquement a l'interieur des accolades 
de la fonction main. Jusqu'ici nos programmes etaient courts, done qa ne posait pas de 
gros problemes, mais imaginez des plus gros programmes qui font des milliers de lignes 
de code ! Si tout etait concentre dans la fonction main, bonjour le bazar. . . 

Nous allons done maintenant apprendre a nous organiser. Nous allons en fait decouper 
nos programmes en petits bouts (souvenez-vous de l'image des Legos que je vous ai 
donnee tout a l'heure). Chaque « petit bout de programme » sera ce qu'on appelle une 
fonction. 

Une fonction execute des actions et renvoie un resultat. C'est un morceau de code 
qui sert a faire quelque chose de precis. On dit qu'une fonction possede une entree et 
une sortie. La fig. 9.2 represente une fonction schematiquement. 

Lorsqu'on appelle une fonction, il y a trois etapes. 

1. L'entree : on fait « rentrer » des informations dans la fonction (en lui donnant 
des informations avec lesquelles travailler). 
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Entree 



Fonction 



Sari in 



Figure 9.2 - Une fonction a une entree et une sortie 



2. Les calculs : grace aux informations qu'elle a regues en entree, la fonction tra- 
vaille. 

3. La sortie : une fois qu'elle a fini ses calculs, la fonction renvoie un resultat. C'est 
ce qu'on appelle la sortie, ou encore le retour. 

Concretement, on peut imaginer par exemple une fonction appelee triple qui calcule 
le triple du nombre qu'on lui donne, en le multipliant par 3 1 (fig. 9.3). 



10 



triple 



30 



La fonction « triple » multiplie le 
nombre en entree par 3 

Figure 9.3 - Entree et sortie de la fonction triple 

Le but des fonctions est done de simplifier le code source, pour ne pas avoir a retaper 
le mime code plusieurs fois d'affilee. 

Revez un peu : plus tard, nous creerons par exemple une fonction af f icherFenetre qui 
ouvrira une fenetre a l'ecran. Une fois la fonction ecrite (c'est l'etape la plus difficile), on 
n'aura plus qu'a dire « Hep ! toi la fonction aff icherFenetre, ouvre-moi une fenetre ! ». 
On pourra aussi ecrire une fonction deplacerPersonnage dont le but sera de deplacer 
le personnage d'un jeu a l'ecran, etc. 

Schema d'une fonction 

Vous avez deja eu un apercu de la fagon dont est faite une fonction avec la fonction 
main. Cependant pour bien que vous compreniez il va falloir que je vous montre quand 
meme comment on construit une fonction. 

Le code suivant represente une fonction schematiquement. C'est un modele a connaitre : 

type nomFonction(parametres) 
{ 

// Inserez vos instructions ici 
} 

Vous reconnaissez la forme de la fonction main. Void ce qu'il faut savoir sur ce schema. 



1. Bien entendu, les fonctions seront en general plus compliquees. 

Ill 



CHAPITRE 9. LES FONCTIONS 



- type (correspond a la sortie) : c'est le type de la fonction. Comme les variables, les 
fonctions ont un type. Ce type depend du resultat que la fonction renvoie : si la 
fonction renvoie un nombre decimal, vous mettrez surement double, si elle renvoie 
un entier vous mettrez int ou long par exemple. Mais il est aussi possible de creer 
des fonctions qui ne renvoient rien ! II y a done deux sortes de fonctions : 

- les fonctions qui renvoient une valeur : on leur met un des types que l'on connait 
(char, int, double, etc.) ; 

- les fonctions qui ne renvoient pas de valeur : on leur met un type special void (qui 
signifie « vide »). 

- nomFonction : c'est le nom de votre fonction. Vous pouvez appeler votre fonction 
comme vous voulez, du temps que vous respectez les mtaies regies que pour les 
variables (pas d'accents, pas d'espaces, etc.). 

- parametres (correspond a l'entree) : entre parentheses, vous pouvez envoyer des 
parametres a la fonction 2 . Ce sont des valeurs avec lesquelles la fonction va travailler. 
Par exemple, pour une fonction triple, vous envoyez un nombre en parametre. La 
fonction « recupere » ce nombre et en calcule le triple, en le multipliant par 3. Elle 
renvoie ensuite le resultat de ses calculs. 

- Ensuite vous avez les accolades qui indiquent le debut et la fin de la fonction. A 
l'interieur de ces accolades vous mettrez les instructions que vous voulez. Pour la 
fonction triple, il faudra taper des instructions qui multiplient par 3 le nombre 
regu en entree. 

Une fonction, c'est done un mecanisme qui regoit des valeurs en entree (les parametres) 
et qui renvoie un resultat en sortie. 

Creer une fonction 

Voyons un exemple pratique sans plus tarder : la fameuse fonction triple dont je vous 
parle depuis tout a l'heure. On va dire que cette fonction regoit un nombre entier de 
type int et qu'elle renvoie un nombre entier aussi de type int. Cette fonction calcule 
le triple du nombre qu'on lui donne : 

int triple (int nombre) 
{ 

int resultat = 0; 

resultat = 3 * nombre; // On multiplie le nombre fourni par 3 

return resultat; // On retourne la variable resultat qui vaut le 

«-> triple de nombre 

} 

Voila notre premiere fonction ! Une premiere chose importante : comme vous le voyez, 
la fonction est de type int. Elle doit done renvoyer une valeur de type int. 

Entre les parentheses, vous avez les variables que la fonction regoit. Ici, notre fonction 
triple regoit une variable de type int appelee nombre. 



2. Vous pouvez envoyer autant de parametres que vous le voulez. Vous pouvez aussi n'envoyer 
aucun parametre a la fonction, mais ga se fait plus rarement. 
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La ligne qui donne pour consigne de « renvoyer une valeur » est celle qui contient le 
return. Cette ligne se trouve generalement a la fin de la fonction, apres les calculs. 

I return resultat; 

Ce code signifie pour la fonction : « Arrete-toi la et renvoie le nombre resultat ». 
Cette variable resultat DOIT etre de type int, car la fonction renvoie un int comme 
on l'a dit plus haut. 

La variable resultat est declaree (= creee) dans la fonction triple. Cela signifie 
qu'elle n'est utilisable que dans cette fonction, et pas dans une autre comme la fonction 
main par exemple. C'est done une variable propre a la fonction triple. 

Mais est-ce la fagon la plus courte d'ecrire notre fonction triple ? Non, on peut faire 
tout cela en une ligne en fait : 

int triple (int nombre) 
{ 

return 3 * nombre ; 
} 

Cette fonction fait exactement la meme chose que la fonction de tout a l'heure, elle est 
juste plus rapide a ecrire 3 . 

Plusieurs parametres, aucun parametre 

Plusieurs parametres 

Notre fonction triple contient un parametre, mais il est possible de creer des fonctions 
acceptant plusieurs parametres. Par exemple, une fonction addition qui additionne 
deux nombres a et b : 

int addition(int a, int b) 
{ 

return a + b; 
} 

II suffit de separer les differents parametres par une virgule comme vous le voyez. 

Aucun parametre 

Certaines fonctions, plus rares, ne prennent aucun parametre en entree. Ces fonctions 
feront generalement toujours la meme chose. En effet, si elles n'ont pas de nombres sur 



3. Generalement, vos fonctions contiendront plusieurs variables pour effectuer leurs calculs et leurs 
operations, rares seront les fonctions aussi courtes que triple. 
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lesquels travailler, vos fonctions serviront juste a effectuer certaines actions, comme 
afficher du texte a l'ecran 4 . 

Imaginons une fonction bonjour qui affiche juste « Bonjour » a l'ecran : 

void bonjourO 
{ 

printf ("Bonjour") ; 
} 

Je n'ai rien mis entre parentheses car la fonction ne prend aucun parametre. De plus, 
j'ai utilise le type void dont je vous ai parle plus haut. 

En effet, comme vous le voyez ma fonction n'a pas non plus de return. Elle ne retourne 
rien. Une fonction qui ne retourne rien est de type void. 



Appeler une fonction 

On va maintenant tester un code source pour s'entrainer un peu avec ce qu'on vient 
d'apprendre. Nous allons utiliser notre fonction triple (decidement je l'aime bien) 
pour calculer le triple d'un nombre. 

Pour le moment, je vous demande d'ecrire la fonction triple AVANT la fonction main. 
Si vous la placez apres, <ja ne marchera pas. Je vous expliquerai pourquoi par la suite. 

Voici un code a tester et a comprendre : 

#include <stdio.h> 
#include <stdlib.h> 

int triple (int nombre) 
{ 

return 3 * nombre ; 
} 

int main(int argc, char *argv[]) 
{ 

int nombreEntre = , nombre Triple = ; 

printf ("Entrez un nombre... ") ; 
scanf ("*/,d" , ftnombreEntre) ; 

nombreTriple = triple (nombreEntre) ; 

printf ("Le triple de ce nombre est */,d\n" , nombreTriple); 

return 0; 



4. Et encore, ce sera forcement toujours le meme texte puisque la fonction ne recoit aucun parametre 
susceptible de modifier son comportement ! 
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> Code web : 815496 



Notre programme commence par la fonction main comme vous le savez. On demande a 
l'utilisateur d'entrer un nombre. On envoie ce nombre qu'il a entre a la fonction triple, 
et on recupere le resultat dans la variable nombreTriple. Regardez en particulier cette 
ligne, c'est la plus interessante car c'est l'appel de la fonction : 

I nombreTriple = triple (nombreEntre) ; 

Entre parentheses, on envoie une variable en entree a la fonction triple, c'est le 
nombre sur lequel elle va travailler. Cette fonction renvoie une valeur, valeur qu'on 
recupere dans la variable nombreTriple. On ordonne done a l'ordinateur dans cette 
ligne : « Demande a la fonction triple de me calculer le triple de nombreEntre, et 
stocke le resultat dans la variable nombreTriple ». 

Les memes explications sous forme de schema 

Vous avez encore du mal a comprendre comment <ja fonctionne concretement ? Pas de 
panique ! Je suis sur que vous allez comprendre avec mes schemas. 

Ce code particulierement commente vous indique dans quel ordre le code est lu. Com- 
mencez done par lire la ligne numerotee 1, puis 2, puis 3 (bon vous avez compris je 
crois !) : 

#include <stdio.h> 
#include <stdlib.h> 

int triple (int nombre) // 6 
{ 

return 3 * nombre; // 7 
} 

int main(int argc, char *argv[]) // 1 
{ 

int nombreEntre = 0, nombreTriple =0; 111 

printf ("Entrez un nombre... ") ; // 3 
scanf ("*/,d" , ftnombreEntre) ; // 4 

nombreTriple = triple (nombreEntre) ; // 5 

printf ("Le triple de ce nombre est '/,d\n" , nombreTriple); // 8 

return 0; // 9 



Voici ce qui se passe, ligne par ligne. 

1. Le programme commence par la fonction main. 
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2. II lit les instructions dans la fonction une par une dans l'ordre. 

3. II lit l'instruction suivante et fait ce qui est demande (printf). 

4. De meme, il lit l'instruction et fait ce qui est demande (scanf). 

5. II lit l'instruction. . . Ah ! On appelle la fonction triple, on doit done sauter a la 
ligne de la fonction triple plus haut. 

6. On saute a la fonction triple et on recupere un parametre (nombre). 

7. On fait des calculs sur le nombre et on termine la fonction. return signifie la fin 
de la fonction et permet d'indiquer le resultat a renvoyer. 

8. On retourne dans le main a l'instruction suivante. 

9. Un return ! La fonction main se termine et done le programme est termine. 

Si vous avez compris dans quel ordre l'ordinateur lit les instructions, vous avez deja 
compris le principal. Maintenant, il faut bien comprendre qu'une fonction regoit des 
parametres en entree et renvoie une valeur en sortie (fig. 9.4). 



2) La fonction triple 

retourne (return) une 

valeur. 

Cette valeur, e'est 3x 

le nombre qu'on lui a 

envoye. 

Cette valeur de 
retour est stocked 
dans la variable 
nombreTriple de la 
fonction main. 
Le signe « = » 
permet done de dire 
« Envoie le resultat 
de la fonction dans 
cette variable ». 




# include <stdio.h> 
# include <stdlib.h> 



int triple (int nombre) 



return 3 * nombre 




main (int argc H char "arov[]) 

int nombreEntre ■ 0, nombreTriple 



printf ("Entrez un nombre.. 
scanf ( pt *d w H snombreEntre) ; 



nombreTriple = triple (nombreEntre) ; 

printf ( w Le triple de ce nombre est %d\n", nombreTriple) 



1) La variable nombreEntre 
est envoyee en parametre a 
la fonction triple. Celle-ci 
recupere cette variable dans 
une autre variable qui 
s'appelle « nombre ». 

Note : on auraitaussi pu 
mettre le meme nom de 
variable dans les 2 fonctions. 
n'y aurait pas eu de conflit, 
car une variable appartient a 
sa fonction. 



Figure 9.4 - Fonction et return 

Note : ce n'est pas le cas de toutes les fonctions. Parfois, une fonction ne prend aucun 
parametre en entree, ou au contraire elle en prend plusieurs (je vous ai explique ga 
un peu plus haut). De meme, parfois une fonction renvoie une valeur, parfois elle ne 
renvoie rien (dans ce cas il n'y a pas de return). 



Testons ce programme 

Voici un exemple d 'utilisation du programme 



Entrez un nombre. . . 10 

Le triple de ce nombre est 30 
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CREER ET APPELER UNE FONCTION 

Vous n'etes pas obliges de stocker le resultat d'une fonction dans une variable I 
Vous pouvez directement envoyer le resultat de la fonction triple a une autre 
fonction, comme si triple (nombreEntre) etait une variable. 



Regardez bien ceci, c'est le meme code mais il y a un changement au niveau du dernier 
printf . De plus, on n'a pas declare de variable nombreTriple car on ne s'en sert plus : 



#include <stdio.h> 
#include <stdlib.h> 

int triple (int nombre) 
{ 

return 3 * nombre ; 
} 

int main (int argc, char *argv[]) 
{ 

int nombreEntre = 0; 

printf ("Entrez un nombre... ") ; 
scanf C'/.d" , ftnombreEntre) ; 

// Le resultat de la fonction est directement envoye au printf et n'est pas 
<— ¥ stocke dans une variable 

printf ("Le triple de ce nombre est */,d\n" , triple (nombreEntre) ) ; 

return ; 



Comme vous le voyez, triple (nombreEntre) est directement envoye au printf. Que 
fait l'ordinateur quand il tombe sur cette ligne ? 

C'est tres simple. II voit que la ligne commence par printf, il va done appeler la 
fonction printf. II envoie a la fonction printf tous les parametres qu'on lui donne. Le 
premier parametre est le texte a afficher et le second est un nombre. Votre ordinateur 
voit que pour envoyer ce nombre a la fonction printf il doit d'abord appeler la fonction 
triple. C'est ce qu'il fait : il appelle triple, il effectue les calculs de triple et une 
fois qu'il a le resultat il l'envoie directement dans la fonction printf ! 

C'est un peu une imbrication de fonctions. Et le plus fin dans tout <ja, c'est qu'une 
fonction peut en appeler une autre a son tour ! Notre fonction triple pourrait appeler 
une autre fonction, qui elle-meme appellerait une autre fonction, etc. C'est <ja le principe 
de la programmation en C ! Tout est combine, comme dans un jeu de Lego. 

Au final, le plus dur sera d'ecrire vos fonctions. Une fois que vous les aurez ecrites, vous 
n'aurez plus qu'a appeler les fonctions sans vous soucier des calculs qu'elles peuvent 
bien faire a l'interieur. C a va permettre de simplifier considerablement l'ecriture de nos 
programmes et <ja croyez-moi on en aura bien besoin ! 
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Des exemples pour bien comprendre 

Vous avez du vous en rendre compte : je suis un maniaque des exemples. La theorie 
c'est bien, mais si on ne fait que ga on risque de ne pas retenir grand-chose et surtout 
ne pas comprendre comment s'en servir, ce qui serait un peu dommage. . . 

Je vais done maintenant vous montrer plusieurs exemples d'utilisation de fonctions, 
pour que vous ayez une idee de leur interet. Je vais m'efforcer de faire des cas differents 
a chaque fois, pour que vous puissiez avoir des exemples de tous les types de fonctions 
qui peuvent exister. 

Je ne vous apprendrai rien de nouveau, mais ce sera l'occasion de voir des exemples 
pratiques. Si vous avez deja compris tout ce que j'ai explique avant, c'est tres bien et 
normalement aucun des exemples qui vont suivre ne devrait vous surprendre. 

Conversion euros / francs 

On commence par une fonction tres similaire a triple, qui a quand meme un minimum 
d'interet cette fois : une fonction qui convertit les euros en francs. Pour ceux d'entre 
vous qui ne connaitraient pas ces monnaies sachez que 1 euro = 6,55957 francs. 

On va creer une fonction appelee conversion. Cette fonction prend une variable en 
entree de type double et retourne une sortie de type double car on va forcement 
manipuler des nombres decimaux. Lisez-la attentivement : 

double conversion(double euros) 
{ 

double francs = 0; 

francs = 6.55957 * euros; 
return francs; 
} 

int main(int argc, char *argv[]) 
{ 

printf("10 euros = '/,f F\n" , conversion(lO) ) ; 

printf("50 euros = '/,f F\n" , conversion(50) ) ; 

printf("100 euros = '/,fF\n", conversion(lOO) ) ; 

printf("200 euros = '/.fF\n", conversion(200) ) ; 

return 0; 



> [ Code web : 786549 ) 

10 euros = 65.595700F 
50 euros = 327.978500F 
100 euros = 655.957000F 
200 euros = 1311.914000F 
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II n'y a pas grand-chose de different par rapport a la fonction triple, je vous avais 
prevenus. D'ailleurs, ma fonction conversion est un peu longue et pourrait etre rac- 
courcie en une ligne, je vous laisse le faire je vous ai deja explique comment faire plus 
haut. 

Dans la fonction main, j'ai fait expres de faire plusieurs printf pour vous montrer 
l'interet d'avoir une fonction. Pour obtenir la valeur de 50 euros, je n'ai qu'a ecrire 
conversion(50). Et si je veux avoir la conversion en francs de 100 euros, j'ai juste 
besoin de changer le parametre que j'envoie a la fonction (100 au lieu de 50). 

A vous de jouer ! Ecrivez une seconde fonction (toujours avant la fonction main) qui 
fera elle la conversion inverse : Francs => Euros. Ce ne sera pas bien difficile, il y a 
juste un signe d'operation a changer. 



La punition 

On va maintenant s'interesser a une fonction qui ne renvoie rien (pas de sortie). C'est 
une fonction qui affiche le meme message a l'ecran autant de fois qu'on lui demande. 
Cette fonction prend un parametre en entree : le nombre de fois ou il faut afficher la 
punition. 



void punition(int nombreDeLignes) 
{ 

int i; 

for (i = ; i < nombreDeLignes ; i++) 
{ 

printf ("Je ne dois pas recopier mon voisin\n") ; 
} 
} 

int main (int argc, char *argv[]) 
{ 

punition(lO) ; 

return ; 
} 



> ( Code web : 805343 ) 
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On a ici affaire a une fonction qui ne renvoie aucune valeur. Cette fonction se contente 
juste d'effectuer des actions (ici, elle affiche des messages a l'ecran). Une fonction qui 
ne renvoie aucune valeur est de type void, c'est pour cela qu'on a ecrit void. A part 
<ja, il n'y a rien de bien different. 

II aurait ete bien plus interessant de creer une fonction punition qui s'adapte a n'im- 
porte quelle sanction. On lui aurait envoye deux parametres : le texte a repeter et le 
nombre de fois qu'il doit etre repete. Le probleme, c'est qu'on ne sait pas encore gerer 
le texte en C 5 . D'ailleurs a ce sujet, je vous annonce que nous ne tarderons pas a 
apprendre a utiliser des variables qui retiennent du texte. C'est plus complique qu'il 
n'y parait et on ne pouvait pas l'apprendre des le debut du cours ! 

Aire d'un rectangle 

L'aire d'un rectangle est facile a calculer : largeur * hauteur. Notre fonction nominee 
aireRectangle va prendre deux parametres : la largeur et la hauteur. Elle renverra 
l'aire. 

double aireRectangle (double largeur, double hauteur) 
{ 

return largeur * hauteur; 
} 

int main(int argc, char *argv[]) 
{ 

printf ("Rectangle de largeur 5 et hauteur 10. Aire = */,f\n", aireRectangle (5, 
^ 10)); 

printf ("Rectangle de largeur 2.5 et hauteur 3.5. Aire = */,f\n", aireRectangle 
<-> (2.5, 3.5)); 

printf ("Rectangle de largeur 4.2 et hauteur 9.7. Aire = '/,f\n", aireRectangle 
<-> (4.2, 9.7)); 

return 0; 
} 



5. Au cas ou vous n'auriez pas vu, je vous rappelle qu'on n'a fait que manipuler des variables 
contenant des nombres depuis le debut du cours ! 
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> Code web : 378159 
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5 
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Aire = 50.000000 
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5. Aire = 8.750000 
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de 
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7. Aire = 40.740000 




)^ Pourrait-on afficher directement la largeur, la hauteur et I'aire dans la fonc- 
tion? 



Bien sur ! Dans ce cas, la fonction ne renverrait plus rien, elle se contenterait de calculer 
I'aire et de l'afficher immediatement. 

void aireRectangle (double largeur, double hauteur) 
{ 

double aire = ; 

aire = largeur * hauteur; 

printf ("Rectangle de largeur '/,f et hauteur '/,f . Aire = '/,f\n", largeur, 
'-¥ hauteur, aire) ; 
} 

int main(int argc, char *argv[]) 
{ 

aireRectangle (5, 10); 

aireRectangle (2.5, 3.5); 

aireRectangle (4. 2, 9.7); 

return ; 
} 

Comme vous le voyez, le printf est a I'interieur de la fonction aireRectangle et pro- 
duit le meme affichage que tout a l'heure. C'est juste une fagon differente de proceder. 

Un menu 

Ce code est plus interessant et concret. On cree une fonction menu() qui ne prend 
aucun parametre en entree. Cette fonction se contente d'afHcher le menu et demande 
a l'utilisateur de faire un choix. La fonction renvoie le choix de l'utilisateur. 

int menu ( ) 
{ 

int choix = 0; 

while (choix < 1 I I choix > 4) 
{ 

printf ("Menu :\n"); 
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printf("l : Poulet de dinde aux escargots rotis a la sauce bearnaise\n") 

^ ; 

printf("2 : Concombres sucres a la sauce de myrtilles enrobee de chocola 
^ t\n"); 

printf("3 : Escalope de kangourou saignante et sa gelee aux f raises poiv 
<^-> ree\n"); 

printf("4 : La surprise du Chef (j'en salive d'avance . . . )\n") ; 

printf ("Votre choix ? "); 

scanf ("*/,d" , ftchoix) ; 
} 

return choix; 
} 

int main(int argc, char *argv[]) 
{ 

switch (menuO) 
{ 

case 1: 

printf ("Vous avez pris le poulet\n"); 
break; 
case 2: 

printf ("Vous avez pris les concombres\n") ; 
break; 
case 3: 

printf ("Vous avez pris l'escalope\n") ; 
break; 
case 4: 

printf ("Vous avez pris la surprise du Chef. Vous etes un sacre 
<—} aventurier dites done !\n"); 

break; 
} 



return 0; 



> [Code web : 114045) 

J'en ai profite pour ameliorer le menu (par rapport a ce qu'on faisait habituellement) : 
la fonction menu affiche a nouveau le menu tant que l'utilisateur n'a pas entre un nombre 
compris entre 1 et 4. Comme ga, aucun risque que la fonction renvoie un nombre qui 
ne figure pas au menu ! 

Dans le main, vous avez vu qu'on fait un switch (menu () ) . Une fois que la fonction 
menu() est terminee, elle renvoie le choix de l'utilisateur directement dans le switch. 
C'est une methode rapide et pratique. 

A vous de jouer ! Le code est encore ameliorable : on pourrait afficher un message 
d'erreur si l'utilisateur entre un mauvais nombre plutot que de simplement afficher une 
nouvelle fois le menu. 
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En resume 

- Les fonctions s'appellent entre elles. Ainsi, le main peut appeler des fonctions toutes 
pretes telles que printf ou scanf , mais aussi des fonctions que nous avons creees. 

- Une fonction recupere en entree des variables qu'on appelle parametres. 

- Elle effectue certaines operations avec ces parametres puis retourne en general une 
valeur a l'aide de l'instruction return. 
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Deuxieme partie 

Techniques « avancees » du 
langage C 
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Chapitre 



10 



La programmation modulaire 



Difficulty : WB 

Dans cette seconde partie, nous allons decouvrir des concepts plus avances du langage 
C. Je ne vous le cache pas, et vous vous en doutiez surement, la partie II est d'un 
cran de difficulty superieur. Lorsque vous serez arrives a la fin de cette partie, vous 
serez capables de vous debrouiller dans la plupart des programmes ecrits en C. Dans la 
partie suivante nous verrons alors comment ouvrir une fenetre, creer des jeux 2D, etc. 

Jusqu'ici nous n'avons travaille que dans un seul fichier appele main.c. Pour le moment 
c'etait acceptable car nos programmes etaient tout petits, mais ils vont bientot etre com- 
poses de dizaines, que dis-je de centaines de fonctions, et si vous les mettez toutes dans 
un meme fichier celui-la va finir par devenir tres long I C'est pour cela que Ton a invente ce 
qu'on appelle la programmation modulaire. Le principe est tout bete : plutot que de placer 
tout le code de notre programme dans un seul fichier (main.c), nous le « separons » en 
plusieurs petits fichiers. 
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Les prototypes 

Jusqu'ici, je vous ai demande de placer votre fonction avant la fonction main. Pourquoi ? 

Parce que l'ordre a une reelle importance ici : si vous mettez votre fonction avant le 
main dans votre code source, votre ordinateur l'aura lue et la connaitra. Lorsque vous 
ferez un appel a la fonction dans le main, l'ordinateur connaitra la fonction et saura 
ou aller la chercher. En revanche, si vous mettez votre fonction apres le main, ga ne 
marchera pas car l'ordinateur ne connaitra pas encore la fonction. Essayez, vous verrez ! 



Mais. . . c'est un peu mal fait, non ? 



Tout a fait d'accord avec vous ! Mais rassurez-vous, les programmeurs s'en sont rendu 
compte avant vous et ont prevu le coup. 

Grace a ce que je vais vous apprendre maintenant, vous pourrez positionner vos fonc- 
tions dans n'importe quel ordre dans le code source. C'est mieux de ne pas avoir a s'en 
soucier, croyez-moi. 

Le prototype pour annoncer une fonction 

Nous allons « annoncer » nos fonctions a l'ordinateur en ecrivant ce qu'on appelle des 
prototypes. Ne soyez pas intimides par ce nom high-tech, <ja cache en fait quelque 
chose de tres simple. 

Regardez la premiere ligne de notre fonction aireRectangle : 

double aireRectangle (double largeur, double hauteur) 
{ 

return largeur * hauteur; 
} 

Copiez la premiere ligne (double aireRectangle. . .) tout en haut de votre fichier 
source (juste apres les #include). Rajoutez un point- virgule a la fin de cette nou- 
velle ligne. Et voila! Maintenant, vous pouvez placer votre fonction aireRectangle 
apres la fonction main si vous le voulez ! 

Vous devriez avoir le code suivant sous les yeux : 

#include <stdio.h> 
#include <stdlib.h> 

// La ligne suivante est le prototype de la fonction aireRectangle : 
double aireRectangle (double largeur, double hauteur); 

int main(int argc, char *argv[]) 
{ 
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printf ("Rectangle de largeur 5 et hauteur 10. Aire = */,f \n" , aireRectangle(5, 
^ 10)); 

printf ("Rectangle de largeur 2.5 et hauteur 3.5. Aire = '/,f\n", aireRectangle 
<-> (2.5, 3.5)); 

printf ("Rectangle de largeur 4.2 et hauteur 9.7. Aire = '/,f\n", aireRectangle 
<-> (4.2, 9.7)); 

return ; 
} 

// Notre fonction aireRectangle peut maintenant etre mise n'importe ou dans le 

<-> code source : 

double aireRectangle (double largeur, double hauteur) 

{ 

return largeur * hauteur; 
} 

> ( Code web : 387723 ) 

Ce qui a change ici, c'est l'ajout du prototype en haut du code source. Un prototype, 
c'est en fait une indication pour l'ordinateur. Cela lui indique qu'il existe une fonction 
appelee aireRectangle qui prend tels parametres en entree et renvoie une sortie du 
type que vous indiquez. Cela permet a l'ordinateur de s'organiser. 

Grace a cette ligne, vous pouvez maintenant placer vos fonctions dans n'importe quel 
ordre sans vous prendre la tete ! 

Ecrivez toujours les prototypes de vos fonctions. Vos programmes ne vont pas tarder a se 
complexifier et a utiliser de nombreuses fonctions : mieux vaut prendre des maintenant 
la bonne habitude d'ecrire le prototype de chacune d'elles. 

Comme vous le voyez, la fonction main n'a pas de prototype. En fait, c'est la seule qui 
n'en necessite pas, parce que l'ordinateur la connait (c'est toujours la meme pour tous 
les programmes, alors il peut bien la connaitre, a force!). 

Pour etre tout a fait exact, il faut savoir que dans la ligne du prototype il est facultatif 
d'ecrire les noms de variables en entree. L'ordinateur a juste besoin de connaitre les 
types des variables. 

On aurait done pu simplement ecrire : 

I double aireRectangle (double, double); 

Toutefois, l'autre methode que je vous ai montree tout a l'heure fonctionne aussi bien. 
L'avantage avec ma methode, c'est que vous avez juste besoin de copier-coller la pre- 
miere ligne de la fonction et de rajouter un point- virgule. Qa, va plus vite. 



© 



N'oubliez JAMAIS de mettre un point-virgule a la fin d'un prototype. C'est 
ce qui permet a l'ordinateur de differencier un prototype du veritable de- 
but d'une fonction. Si vous ne le faites pas, vous risquez d'avoir des erreurs 
incomprehensibles lors de la compilation. 
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Les headers 

Jusqu'ici, nous n'avions qu'un seul fichier source dans notre projet. Ce fichier source, 
je vous avais demande de l'appeler main. c. 

Plusieurs fichiers par projet 

Dans la pratique, vos programmes ne seront pas tous ecrits dans ce meme fichier main. c. 
Bien sur, il est possible de le faire, mais ce n'est jamais tres pratique de se balader dans 
un fichier de 10 000 lignes (enfin, personnellement, je trouve!). C'est pour cela qu'en 
general on cree plusieurs fichiers par projet. 




O 



Qu'est-ce qu'un projet, deja? 



Non, vous n'avez pas deja oublie? Bon : je vous le reexplique, parce qu'il est important 
qu'on soit bien d'accord sur ce terme. 

Un projet, c'est l'ensemble des fichiers source de votre programme. Pour le moment, 
nos projets n'etaient composes que d'un fichier source. Regardez dans votre IDE, ge- 
neralement c'est sur la gauche (fig. 10.1). 



Management 


X 


main.c X 




Projects Symbols 


<1 ► 




1 
2 
3 

4 
5 
6 
7 
n 


# include <s m 


Q-^J Workspace 

B-5 test 

Q-{F^ Sources 

main.c 




# include <s - 

double trip! 
EM 

return : 



Figure 10.1 - Liste des fichiers d'un projet simple 

Comme vous pouvez le voir a gauche sur cette capture d'ecran, ce projet n'est compose 
que d'un fichier main. c. 

Laissez-moi maintenant vous montrer un vrai projet que vous realiserez un peu plus 
loin dans le cours : un jeu de Sokoban (fig. 10.2). 

Comme vous le voyez, il y a plusieurs fichiers. Un vrai projet ressemblera a ga : vous ver- 
rez plusieurs fichiers dans la colonne de gauche. Vous reconnaissez dans la liste le fichier 
main.c : c'est celui qui contient la fonction main. En general dans mes programmes, je 
ne mets que le main dans main, c . 



Mais pourquoi avoir cree plusieurs fichiers? Et comment je sais combien de 
fichiers je dois creer pour mon projet? 




O 



1. Pour information, ce n'est pas du tout une obligation, chacun s'organise comme il veut. Pour 
bien me suivre, je vous conseille neanmoins de faire comme moi. 
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#ifndef 






■■■■_] constantes.h 
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# define 






■■■■_] editeur.h 
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■■■■ j fichiers.h 


13 


#de: 






■■■■ j jeu.h 


14 


#de: 



Figure 10.2 - Liste des fichiers d'un projet plus complexe 



Qa, c'est vous qui choisissez. En general, on regroupe dans un meme fichier des fonctions 
ayant le meme theme. Ainsi, dans le fichier editeur . c j'ai regroupe toutes les fonctions 
concernant l'editeur de niveau ; dans le fichier jeu. c, j'ai regroupe toutes les fonctions 
concernant le jeu lui-meme, etc. 



Fichiers . h et . c 

Comme vous le voyez, il y a deux types de fichiers differents sur la fig. 10.2. 

- Les .h, appeles fichiers headers. Ces fichiers contiennent les prototypes des fonctions. 

- Les .c : les fichiers source. Ces fichiers contiennent les fonctions elles-memes. 

En general, on met done rarement les prototypes dans les fichiers . c comme on l'a fait 
tout a l'heure dans le main.c (sauf si votre programme est tout petit). 

Pour chaque fichier . c , il y a son equivalent .h qui contient les prototypes des fonctions. 
Jetez un ceil plus attentif a la fig. 10.2 : 

- il y a editeur. c (le code des fonctions) et editeur.h (les prototypes des fonctions) ; 

- il y a j eu . c et j eu . h ; 

- etc. 




<? 



O 



Mais comment faire pour que I'ordinateur sache que les prototypes sont dans 
un autre fichier que le . c? 



II faut inclure le fichier .h grace a une directive de preprocesseur. Attention, preparez- 
vous a comprendre beaucoup de choses d'un coup ! 

Comment inclure un fichier header ?. . . Vous savez le faire, vous l'avez deja fait ! 

Regardez par exemple le debut de mon fichier j eu . c : 
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#include <stdlib.h> 
#include <stdio.h> 
#include "jeu.h" 

void jouer (SDL_Surface* ecran) 
{ 

// ... 

L'inclusion se fait grace a la directive de preprocesseur #include que vous connaissez 
bien maintenant. Regardez les premieres lignes du code source ci-dessus : 

#include <stdlib.h> 

#include <stdio.h> 

#include "jeu.h" // On inclut jeu.h 

On inclut trois fichiers .h : stdio, stdlib et jeu. Notez une difference : les fichiers que 
vous avez crees et places dans le repertoire de votre projet doivent etre inclus avec des 
guillemets ("jeu.h") tandis que les fichiers correspondant aux bibliotheques (qui sont 
generalement installes, eux, dans le repertoire de votre IDE) sont inclus entre chevrons 
(<stdio.h>). 

Vous utiliserez done : 

- les chevrons < > pour inclure un fichier se trouvant dans le repertoire « include » 
de votre IDE ; 

- les guillemets " " pour inclure un fichier se trouvant dans le repertoire de votre 
projet (a cote des .c, generalement). 

La commande #include demande d'inserer le contenu du fichier dans le . c. C'est done 
une commande qui dit « Insere ici le fichier jeu.h » par exemple. 

Et dans le fichier jeu.h, que trouve-t-on? On trouve simplement les prototypes des 
fonctions du fichier jeu. c ! 

/* 
jeu.h 



Par mateo2l, pour Le Site du Zero (www.siteduzero.com) 

Role : prototypes des fonctions du jeu. 
*/ 

void jouer(SDL_Surf ace* ecran) ; 

void deplacerJoueur(int carte [] [NB_BLOCS_HAUTEUR] , SDL_Rect *pos, int 
^-> direction) ; 

void deplacerCaisse(int *premiereCase, int *secondeCase) ; 

Voila comment fonctionne un vrai projet ! 
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Quel est I'interet de mettre les prototypes dans des fichiers .h? 



La raison est en fait assez simple. Quand dans votre code vous faites appel a une 
fonction, votre ordinateur doit deja la connaitre, savoir combien de parametres elle 
prend, etc. C'est a ca que sert un prototype : c'est le mode d'emploi de la fonction 
pour l'ordinateur. 

Tout est une question d'ordre : si vous placez vos prototypes dans des .h (headers) 
inclus en haut des fichiers . c, votre ordinateur connaitra le mode d'emploi de toutes 
vos fonctions des le debut de la lecture du fichier. 

En faisant cela, vous n'aurez ainsi pas a vous soucier de l'ordre dans lequel les fonctions 
se trouvent dans vos fichiers . c. Si maintenant vous faites un petit programme conte- 
nant deux ou trois fonctions, vous vous rendrez peut-etre compte que les prototypes 
semblent facultatifs (ca marche sans). Mais ca ne durera pas longtemps ! Des que vous 
aurez un peu plus de fonctions, si vous ne mettez pas vos prototypes de fonctions dans 
des .h, la compilation echouera sans aucun doute. 

Lorsque vous appellerez une fonction situee dans fonctions. c depuis le 
fichier main.c, vous aurez besoin d'inclure les prototypes de fonctions. c 
dans main.c. II faudra done mettre un #include "fonctions. h" en haut 
de main. c. Souvenez-vous de cette regie : a chaque fois que vous faites appel 
a une fonction X dans un fichier, il faut que vous ayez inclus les prototypes 
de cette fonction dans votre fichier. Cela permet au compilateur de verifier si 
vous I'avez correctement appelee. 




a 




f 



o 



Comment puis-je ajouter des fichiers . c et .ha mon projet? 



Qa depend de l'IDE que vous utilisez, mais globalement la procedure est la meme : 
Fichier / Nouveau / Fichier source. Cela cree un nouveau fichier vide. Ce fichier 
n'est pas encore de type . c ou . h, il faut que vous l'enregistriez pour le dire. Enregistrez 
done ce nouveau fichier (meme s'il est encore vide!). On vous demandera alors quel 
nom vous voulez donner au fichier. C'est la que vous choisissez si c'est un . c ou un . h : 

- si vous l'appelez fichier. c, ce sera un . c ; 

- si vous l'appelez fichier. h, ce sera un .h. 

C'est aussi simple que cela. Enregistrez votre fichier dans le repertoire dans lequel se 
trouvent les autres fichiers de votre projet (le meme dossier que main. c). Generalement, 
vous enregistrerez tous vos fichiers dans le meme repertoire, les .c comme les .h. 

Le dossier du projet ressemble au final a la fig. 10.3. Vous y voyez des .c et des .h 
ensemble. 



133 



CHAPITRE 10. LA PROGRAMMATION MODULAIRE 











bz 


E|-£3-] 


)( ) )■ ► sokoban 




- 


| *t | | Rechercher 




P' 




kjggm^ff^tiimm 






- -"•■ "^""" 
























Liens favoris 
1 Jj Tutos 
[) Documents 
£. Images 
1 ^ Musique 
l^ 1 Mcdifie recemment 
Autres » 




Nlom Date de la prise devue 


Mots-cles 


Taille Notation 










■ 


■ 

caisse.jpg 


■ 

caisse_ok.jpg 

u 

h 




h 




L- 

c 






caisse.ico 






constantes.h 




editeur.c 

U 

h 


Dossiers 


V 


r ^ 




L 




l_ 




E Bureau 
13: Mateo 
Public 
l** Ordinateur 
(§* Reseau 

™$ PanneaudeconfigL 
_P Corbeille 


.' 


h 




C 




c 




editeur.h 




fichiers.c 




fichiers.h 




jeu.c 




jeu.h 


^^ MarioSokoban.cb 
]■ i^ project file 

- 


J Datedemodificati... 10/04/200614:51 
Taille: 1,85 Ko 
Date de creation : 10/04/20W 14:51 













Figure 10.3 - Un dossier de projet 



Votre fichier est maintenant enregistre, mais il n'est pas encore vraiment ajoute au 
projet ! Pour l'ajouter au projet, faites un clic droit dans la partie a gauche de l'ecran 
(ou il y a la liste des fichiers du projet) et choisissez Add files (fig. 10.4). 



Projects | Symbols | 



O-^J Workspace 
HI 



[ 



+ [ 



main.c | constantes.h 



Close project 



Add files... 

Adoviles recursively... 

Remove files... 

Find file... 

Add new virtual folder.., 

Build 

Rebuild 

Clean 



1 B 



Ctrl-F9 
Ctrl -Fll 



Figure 10.4 - Ajout de fichiers au projet 

Une fenetre s'ouvre et vous demande quels fichiers ajouter au projet. Selectionnez le 
fichier que vous venez de creer et c'est fait. Le fichier fait maintenant partie du projet 
et apparait dans la liste a gauche ! 
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Les include des bibliotheques standard 

Une question devrait vous trotter dans la tete. . . Si on inclut les fichiers stdio.h et 
stdlib.h, c'est done qu'ils existent quelque part et qu'on peut aller les chercher, non? 

Oui, bien sur ! lis sont normalement installes la ou se trouve votre IDE. Dans mon cas 
sous Code: :Blocks, je les trouve la : 

C:\Program Files\CodeBlocks\MinGW\include 

II faut generalement chercher un dossier include. La-dedans, vous allez trouver de tres 
nombreux fichiers. Ce sont des headers ( .h) des bibliotheques standard, e'est-a-dire des 
bibliotheques disponibles partout (que ce soit sous Windows, Mac, Linux...). Vous y 
retrouverez done stdio.h et stdlib.h, entre autres. 

Vous pouvez les ouvrir si vous voulez, mais <ja risque de piquer un peu les yeux. En effet, 
c'est un peu complique (il y a pas mal de choses qu'on n'a pas encore vues, notamment 
certaines directives de preprocesseur). Si vous cherchez bien, vous verrez que ce fichier 
est rempli de prototypes de fonctions standard, comme printf par exemple. 

Ok, je sais maintenant ou se trouvent les prototypes des fonctions standard. 
Mais comment pourrais-je voir le code source de ces fonctions? Ou sont les 
.c? 

Vous ne les avez pas ! En fait, les fichiers . c sont deja compiles (en code binaire, e'est- 
a-dire en code machine). II est done totalement impossible de les lire. 

Vous pouvez retrouver les fichiers compiles dans un repertoire appele lib 2 . Chez moi, 
on peut les trouver dans le repertoire : 

C:\Program Files\CodeBlocks\MinGW\lib 

Les fichiers compiles des bibliotheques ont l'extension . a sous Code: :Blocks (qui utilise 
le compilateur appele mingw) et ont l'extension .lib sous Visual C++ (qui utilise le 
compilateur Visual). N'essayez pas de les lire : ce n'est absolument pas comestible 
pour un humain. 

En resume, dans vos fichiers .c, vous incluez les .h des bibliotheques standard pour 
pouvoir utiliser des fonctions standard comme printf. Votre ordinateur a ainsi les 
prototypes sous les yeux et peut verifier si vous appelez les fonctions correctement, par 
exemple que vous n'oubliez pas de parametres. 



La compilation separee 

Maintenant que vous savez qu'un projet est compose de plusieurs fichiers source, nous 
pouvons rentrer plus en detail dans le fonctionnement de la compilation. Jusqu'ici, nous 
avions vu un schema tres simplifie. 

La fig. 10.5 est un schema bien plus precis de la compilation. C'est le genre de schemas 



2. C'est l'abreviation de library qui signifie « bibliotheque » en frangais. 
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qu'il est fortement conseille de comprendre et de connaitre par cceur ! 

Preprocesseur Compilateur ,..., . ,. 

(Gditeurde liens) 

(inclusion des . h dans les . c) (transforms chaque _c ert btnaire) (rassembte les .varum, oza) 



h] J=_ 
h c 

hi cl 




Executable (.exej 



Fichiers ,h 



Fichiers .c 



Fichiers .0 (ou .obj) 



Figure 10.5 - Schema d'une compilation 

Qa,, c'est un vrai schema de ce qu'il se passe a la compilation. Detaillons-le. 

1. Preprocesseur : le preprocesseur est un programme qui demarre avant la compi- 
lation. Son rfile est d'executer les instructions speciales qu'on lui a donnees dans 
des directives de preprocesseur, ces fameuses lignes qui commencent par un #. 
Pour l'instant, la seule directive de preprocesseur que l'on connait est #include, 
qui permet d'inclure un fichier dans un autre. Le preprocesseur sait faire d'autres 
choses, mais <ja, nous le verrons plus tard. Le #include est quand meme ce 
qu'il y a de plus important a connaitre. Le preprocesseur « remplace » done les 
lignes #include par le fichier indique. II met a l'interieur de chaque fichier . c le 
contenu des fichiers .h qu'on a demande d'inclure. A ce moment-la de la compi- 
lation, votre fichier . c est complet et contient tous les prototypes des fonctions 
que vous utilisez (votre fichier . c est done un peu plus gros que la normale). 

2. Compilation : cette etape tres importante consiste a transformer vos fichiers 
source en code binaire comprehensible par l'ordinateur. Le compilateur compile 
chaque fichier . c un a un. II compile tous les fichiers source de votre projet, 
d'ou l'importance d'avoir bien ajoute tous vos fichiers au projet (ils doivent tous 
apparaitre dans la fameuse liste a gauche). Le compilateur genere un fichier .o 
(ou . obj , <ja depend du compilateur) par fichier . c compile. Ce sont des fichiers 
binaires temporaires. Generalement, ces fichiers sont supprimes a la fin de la 
compilation, mais selon les options de votre IDE, vous pouvez choisir de les 
conserver 3 . 

3. Edition de liens : le linker (ou « editeur de liens » en frangais) est un programme 
dont le role est d'assembler les fichiers binaires .o. II les assemble en un seul gros 



3. Bien qu'inutiles puisque temporaires, on peut trouver un interet a conserver les .0. En effet, 
si parmi les 10 fichiers . c de votre projet seul l'un d'eux a change depuis la derniere compilation, 
le compilateur n'aura qu'a recompiler seulement ce fichier .c. Pour les autres, il possede deja les .0 
compiles. 
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fichier : l'executable final ! Cet executable a l'extension . exe sous Windows. Si 
vous etes sous un autre OS, il devrait prendre l'extension adequate. 

Maintenant, vous savez comment ga se passe a l'interieur. Je le dis et je le repete, ce 
schema de la fig. 10.5 est tres important. II fait la difference entre un programmeur du 
dimanche qui copie sans comprendre des codes source et un autre qui sait et comprend 
ce qu'il fait. 

La plupart des erreurs surviennent a la compilation, mais il m'est aussi arrive d'avoir 
des erreurs de linker. Cela signifie que le linker n'est pas arrive a assembler tous les . o 
(il en manquait peut-etre). 

Notre schema est par contre encore un peu incomplet. En effet, les bibliotheques n'y 
apparaissent pas ! Comment cela se passe-t-il quand on utilise des bibliotheques ? 

En fait, le debut du schema reste le meme, c'est seulement le linker qui va avoir un peu 
plus de travail. II va assembler vos .o (temporaires) avec les bibliotheques compilees 
dont vous avez besoin (.a ou .lib selon le compilateur). La fig. 10.6 est done une 
version amelioree de la fig. 10.5. 



Linker 

(editeur <je liens) 

(inclusion dss .h dans les . c) (transforme casque .c en binaife) (rassembls les .oenim. exe) 



Preprocesseur Compilateur 



0^ 



hi c 



h c 



Fichiers ,h Fichiers ,c 







Executable {.$x&} 



Fichiers .a (ou .lib) 
(bibtioingquBS compHees, ccmrois stdio) 



Figure 10.6 - Schema d'une compilation avec bibliotheques 



Nous y sommes, le schema est cette fois complet. Vos fichiers de bibliotheques .a (ou 
. lib) sont rassembles dans l'executable avec vos . o. 

C'est comme cela qu'on peut obtenir au final un programme 100 % complet, qui contient 
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toutes les instructions necessaires a l'ordinateur, meme celles qui lui expliquent com- 
ment afficher du texte ! Par exemple, la fonction printf se trouve dans un . a, et sera 
done rassemblee avec votre code source dans l'executable. 

Dans quelque temps, nous apprendrons a utiliser des bibliotheques graphiques. Celles-ci 
seront la aussi dans des . a et contiendront des instructions pour indiquer a l'ordinateur 
comment ouvrir une fenetre a l'ecran, par exemple. Mais patience, car tout vient a point 
a qui sait attendre, e'est bien connu. 



La portee des fonctions et des variables 

Pour clore ce chapitre, il nous faut imperativement decouvrir la notion de portee des 
fonctions et des variables. Nous allons voir quand les variables et les fonctions sont 
accessibles, e'est-a-dire quand on peut faire appel a elles. 



Les variables propres aux fonctions 

Lorsque vous declarez une variable dans une fonction, celle-ci est supprimee de la 
memoire a la fin de la fonction : 

int triple (int nombre) 
{ 

int resultat =0; //La variable resultat est creee en memoire 

resultat = 3 * nombre; 
return resultat; 
} // La fonction est terminee, la variable resultat est supprimee de la memoire 



Une variable declaree dans une fonction n'existe done que pendant que la fonction est 
executee. Qu'est-ce que <ja veut dire, concretement ? Que vous ne pouvez pas y acceder 
depuis une autre fonction ! 

int triple (int nombre); 

int main(int argc, char *argv[]) 
{ 

printf ("Le triple de 15 est */,d\n", triple(15)); 

printf ("Le triple de 15 est 7,d", resultat); // Erreur 

return 0; 



int triple (int nombre) 
{ 
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int resultat = 0; 

resultat = 3 * nombre; 
return resultat ; 
} 

Dans le main, j'essaie ici d'acceder a la variable resultat. Or, comme cette variable 
resultat a ete creee dans la fonction triple, elle n'est pas accessible dans la fonction 
main ! 

Retenez bien : une variable declaree dans une fonction n'est accessible qu'a l'interieur 
de cette fonction. On dit que c'est une variable locale. 

Les variables globales : a eviter 

Variable globale accessible dans tous les fichiers 

II est possible de declarer des variables qui seront accessibles dans toutes les fonctions 
de tous les fichiers du projet. Je vais vous montrer comment faire pour que vous sachiez 
que ga existe, mais generalement il faut eviter de le faire. Ca aura l'air de simplifier 
votre code au debut, mais ensuite vous risquez de vous retrouver avec de nombreuses 
variables accessibles partout, ce qui risquera de vous creer des soucis. 

Pour declarer une variable « globale » accessible partout, vous devez faire la declaration 
de la variable en dehors des fonctions. Vous ferez generalement la declaration tout en 
haut du fichier, apres les #include. 

#include <stdio.h> 
#include <stdlib.h> 

int resultat = 0; // Declaration de variable globale 

void triple (int nombre); // Prototype de fonction 

int main (int argc, char *argv[]) 
{ 

triple(15) ; // On appelle la fonction triple, qui modifie la variable globale 
•-> resultat 

printf("Le triple de 15 est */,d\n" , resultat); // On a acces a resultat 

return ; 
} 

void triple (int nombre) 
{ 

resultat = 3 * nombre; 
} 

Sur cet exemple, ma fonction triple ne renvoie plus rien (void). Elle se contente de 
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modifier la variable globale resultat que la fonction main peut recuperer. 

Ma variable resultat sera accessible dans tous les fichiers du projet, on pourra done 
faire appel a elle dans TOUTES les fonctions du programme. 



A 



Ce type de choses est generalement a bannir dans un programme en C. Utilisez 
plutot le retour de la fonction (return) pour renvoyer un resultat. 



Variable globale accessible uniquement dans un fichier 

La variable globale que nous venons de voir etait accessible dans tous les fichiers du 
projet. II est possible de la rendre accessible uniquement dans le fichier dans lequel elle 
se trouve. Qa, reste une variable globale quand meme, mais disons qu'elle n'est globale 
qu'aux fonctions de ce fichier, et non a toutes les fonctions du programme. 

Pour creer une variable globale accessible uniquement dans un fichier, rajoutez simple- 
ment le mot-cle static devant : 

I static int resultat = 0; 

Variable statique a une fonction 

Attention : e'est un peu plus delicat, ici. Si vous rajoutez le mot-cle static devant 
la declaration d'une variable a l'interieur d'une fonction, <ja n'a pas le meme sens que 
pour les variables globales. En fait, la variable static n'est plus supprimee a la fin de 
la fonction. La prochaine fois qu'on appellera la fonction, la variable aura conserve sa 
valeur. 

Par exemple : 

int triple (int nombre) 
{ 

static int resultat =0; //La variable resultat est creee la premiere fois 
«-> que la fonction est appelee 

resultat = 3 * nombre; 
return resultat; 
} // La variable resultat n'est PAS supprimee lorsque la fonction est terminee. 



Qu'est-ce que <ja signifie, concretement ? Qu'on pourra rappeler la fonction plus tard 
et la variable resultat contiendra toujours la valeur de la derniere fois. 

Voici un petit exemple pour bien comprendre : 
int incrementeO ; 
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int main(int argc, char *argv[]) 

{ 

printf ("*/,d\n" , incrementeO ) 

printf ("*/,d\n" , incrementeO) 

printf ("*/,d\n" , incrementeO) 

printf ("*/,d\n" , incrementeO) 

return ; 
} 

int incrementeO 
{ 

static int nombre = 0; 



nombre++ ; 
return nombre ; 
} 

> ( Code web : 925776 ) 




Ici, la premiere fois qu'on appelle la fonction incremente, la variable nombre est creee. 
Elle est incrementee a 1, et une fois la fonction terminee la variable n'est pas supprimee. 

Lorsque la fonction est appelee une seconde fois, la ligne de la declaration de variable 
est tout simplement « sautee ». On ne recree pas la variable, on reutilise la variable 
qu'on avait deja creee. Comme la variable valait 1, elle vaudra maintenant 2, puis 3, 
puis 4, etc. 

Les fonctions locales a un fichier 

Pour en finir avec les portees, nous allons nous interesser a la portee des fonctions. 
Normalement, quand vous creez une fonction, celle-ci est globale a tout le programme. 
Elle est accessible depuis n'importe quel autre fichier . c. 

II se peut que vous ayez besoin de creer des fonctions qui ne seront accessibles que dans 
le fichier dans lequel se trouve la fonction. 

Pour faire cela, rajoutez le mot-cle static (encore lui) devant la fonction : 

static int triple (int nombre) 
{ 

// Instructions 
} 

Pensez a mettre a jour le prototype aussi : 
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I static int triple (int nombre) ; 

Maintenant, votre fonction static triple ne peut etre appelee que depuis une autre 
fonction du meme fichier. Si vous essayez d'appeler la fonction triple depuis une 
fonction d'un autre fichier, ga ne marchera pas car triple n'y sera pas accessible. 

Resumons tous les types de portee qui peuvent exister pour les variables : 

- Une variable declaree dans une fonction est supprimee a la fin de la fonction, elle 
n'est accessible que dans cette fonction. 

- Une variable declaree dans une fonction avec le mot-cle static devant n'est pas 
supprimee a la fin de la fonction, elle conserve sa valeur au fur et a mesure de 
l'execution du programme. 

- Une variable declaree en dehors des fonctions est une variable globale, accessible 
depuis toutes les fonctions de tous les fichiers source du projet. 

- Une variable globale avec le mot-cle static devant est globale uniquement dans le 
fichier dans lequel elle se trouve, elle n'est pas accessible depuis les fonctions des 
autres fichiers. 

De meme, voici les types de portee qui peuvent exister pour les fonctions : 

- Une fonction est par defaut accessible depuis tous les fichiers du projet, on peut done 
l'appeler depuis n'importe quel autre fichier. 

- Si on veut qu'une fonction ne soit accessible que dans le fichier dans lequel elle se 
trouve, il faut raj outer le mot-cle static devant. 

En resume 

- Un programme contient de nombreux fichiers .c. En regie generale, chaque fichier 
. c a un petit frere du meme nom ayant l'extension .h (qui signifie header). Le 
.c contient les fonctions tandis que le .h contient les prototypes, e'est-a-dire la 
signature de ces fonctions. 

- Le contenu des fichiers . h est inclus en haut des . c par un programme appele pre- 
processeur. 

- Les . c sont transformes en fichiers . o binaires par le compilateur. 

- Les . o sont assembles en un executable ( . exe) par le linker, aussi appele editeur 
de liens. 

- Une variable declaree dans une fonction n'est pas accessible dans une autre fonction. 
On parle de portee des variables. 
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A I'assaut des pointeurs 



Difficulty : HB 

L'heure est venue pour vous de decouvrir les pointeurs. Prenez un grand bol d'air 
avant car ce chapitre ne sera probablement pas une partie de plaisir. Les pointeurs 
representent en effet une des notions les plus delicates du langage C. Si j'insiste autant 
sur leur importance, c'est parce qu'il est impossible de programmer en langage C sans les 
connaTtre et bien les comprendre. Les pointeurs sont omnipresents, nous les avons d'ailleurs 
deja utilises sans le savoir. 

Nombre de ceux qui apprennent le langage C titubent en general sur les pointeurs. Nous 
allons faire en sorte que ce ne soit pas votre cas. Redoublez d'attention et prenez le temps 
de comprendre les nombreux schemas de ce chapitre. 
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Un probleme bien ennuyeux 

Un des plus gros problemes avec les pointeurs, en plus d'etre assez delicats a assimiler 
pour des debutants, c'est qu'on a du mal a comprendre a quoi ils peuvent bien servir. 

Alors bien sur, je pourrais vous dire : « Les pointeurs sont totalement indispensables, 
on s'en sert tout le temps, croyez-moi ! », mais je sais que cela ne vous suffira pas. 

Je vais done vous poser un probleme que vous ne pourrez pas resoudre sans utiliser de 
pointeurs. Ce sera en quelque sorte le fil rouge du chapitre. Nous en reparlerons a la 
fin de ce chapitre et verrons quelle est la solution en utilisant ce que vous aurez appris. 

Voici le probleme : je veux ecrire une fonction qui renvoie deux valeurs. « Impossible » 
me direz-vous ! En effet, on ne peut renvoyer qu'une valeur par fonction : 

int fonctionO 
{ 

return valeur; 
} 

Si on indique int, on renverra un nombre de type int (grace a l'instruction return). 
On peut aussi ecrire une fonction qui ne renvoie aucune valeur avec le mot-cle void : 

void fonctionO 
{ 



Mais renvoyer deux valeurs a la fois. . . c'est impossible. On ne peut pas faire deux 
return. 

Supposons que je veuille ecrire une fonction a laquelle on envoie un nombre de minutes. 
Celle-ci renverrait le nombre d'heures et minutes correspondantes : 

1. si on envoie 45, la fonction renvoie heure et 45 minutes ; 

2. si on envoie 60, la fonction renvoie 1 heure et minutes ; 

3. si on envoie 90, la fonction renvoie 1 heure et 30 minutes. 

Soyons fous, tentons le coup : 

#include <stdio.h> 
#include <stdlib.h> 

/* Je mets le prototype en haut . Comme c'est un tout 
petit programme je ne le mets pas dans un .h, mais 
en temps normal (dans un vrai programme), j'aurais place 
le prototype dans un fichier .h bien entendu */ 

void decoupeMinutes(int heures, int minutes); 
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int main(int argc, char *argv[]) 
{ 

int heures = 0, minutes = 90; 

/* On a une variable minutes qui vaut 90 . 

Apres appel de la fonction, je veux que ma variable 

"heures" vaille 1 et que ma variable "minutes" vaille 30 */ 

decoupeMinutes (heures, minutes); 

printf ("*/,d heures et */,d minutes", heures, minutes); 

return ; 



void decoupeMinutes (int heures, int minutes) 

{ 

heures = minutes / 60; // 90 / 60 = 1 
minutes = minutes '/, 60; // 90 '/, 60 = 30 

} 



> ( Code web : 341586) 
Resultat : 



heures et 90 minutes 



Zut, zut, zut et rezut, ca n'a pas marche. Que s'est-il passe? En fait, quand vous 
« envoyez » une variable a une fonction, une copie de la variable est realisee. Ainsi, 
la variable heures dans la fonction decoupeMinutes n'est pas la meme que celle de la 
fonction main ! C'est simplement une copie ! 

Votre fonction decoupeMinutes fait son job. A l'interieur de decoupeMinutes, les 
variables heures et minutes ont les bonnes valeurs : 1 et 30. 

Mais ensuite, la fonction s'arrete lorsqu'on arrive a l'accolade fermante. Comme on 
l'a appris dans les chapitres precedents, toutes les variables creees dans une fonction 
sont detruites a la fin de cette fonction. Vos copies de heures et de minutes sont done 
supprimees. On retourne ensuite a la fonction main, dans laquelle vos variables heures 
et minutes valent toujours et 90. C'est un echec! 

Notez que, comme une fonction fait une copie des variables qu'on lui envoie, 
vous n'etes pas du tout obliges d'appeler vos variables de la meme facon que 
dans le main. Ainsi, vous pourriez tres bien ecrire : 

void decoupeMinutes (int h, int m) 

h pour heures et m pour minutes. Si vos variables ne s'appellent pas de la meme 
facon dans la fonction et dans le main, ca ne pose done aucun probleme I 
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Bref, vous aurez beau retourner le probleme dans tous les sens. . . vous pouvez essayer 
de renvoyer une valeur avec la fonction (en utilisant un return et en mettant le type 
int a la fonction), mais vous n'arriveriez a renvoyer qu'une des deux valeurs. Vous ne 
pouvez pas renvoyer les deux valeurs a la fois. De plus, vous ne pouvez pas utiliser de 
variables globales car, comme on l'a vu, cette pratique est fortement deconseillee. 

Voila, le probleme est pose. Comment les pointeurs vont-ils nous permettre de le re- 
soudre ? 



La memoire, une question d'adresse 
Rappel des faits 

Petit flash-back. Vous souvenez-vous du chapitre sur les variables ? 

Quelle que soit la reponse, je vous recommande tres vivement d'aller relire la premiere 
partie de ce chapitre, intitulee « Une affaire de memoire ». II y avait un schema tres 
important que je vous propose ici a nouveau (fig. 11.1). 



Adresse 
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3.8028322 




0.827551 




3901930 



3 448 765 900 126 
(et des poussieres) 



940.5118 



Figure 11.1 - Organisation de la memoire vive 

C'est un peu comme <ja qu'on peut representer la memoire vive (RAM) de votre ordi- 
nateur. 
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LA MEMOIRE, UNE QUESTION D'ADRESSE 

II faut lire ce schema ligne par ligne. La premiere ligne represente la « cellule » du 
tout debut de la memoire vive. Chaque cellule a un numero, c'est son adresse 1 . La 
memoire comporte un grand nombre d'adresses, commengant a l'adresse numero et 
se terminant a l'adresse numero (inserez un tres grand nombre id) 2 . 

A chaque adresse, on peut stocker un nombre. Un et UN SEUL nombre. On ne peut 
pas stocker deux nombres par adresse. 

Votre memoire n'est faite que pour stocker des nombres. Elle ne peut stocker ni lettres 
ni phrases. Pour contourner ce probleme, on a invente une table qui fait la liaison entre 
les nombres et les lettres. Cette table dit par exemple : « Le nombre 89 represente la 
lettre Y ». Nous reviendrons dans un prochain chapitre sur la gestion des caracteres ; 
pour l'instant, nous nous concentrons sur le fonctionnement de la memoire. 

Adresse et valeur 

Quand vous creez une variable age de type int par exemple, en tapant <ja : 

I int age = 10; 

. . . votre programme demande au systeme d'exploitation (Windows, par exemple) la 
permission d'utiliser un peu de memoire. Le systeme d'exploitation repond en indiquant 
a quelle adresse en memoire il vous laisse le droit d'inscrire votre nombre. 

C'est d'ailleurs justement la un des roles principaux d'un systeme d'exploitation : on 
dit qu'il alloue de la memoire aux programmes. C'est un peu lui le chef, il controle 
chaque programme et verifie que ce dernier a l'autorisation de se servir de la memoire 
a l'endroit ou il le fait. 

C'est d'ailleurs la la cause n°l de plantage des programmes : si votre pro- 
gramme essaie d'acceder a une zone de la memoire qui ne lui appartient pas, 
le systeme d'exploitation (abregez « OS ») le refuse et coupe brutalement 
le programme en guise de punition (« C'est qui le chef ici ? »). L'utilisateur, 
lui, voit une jolie boTte de dialogue du type « Ce programme va etre arrete 
parce qu'il a effectue une operation non conforme ». 

Revenons a notre variable age. La valeur 10 a ete inscrite quelque part en memoire, 
disons par exemple a l'adresse n°4655. Ce qu'il se passe (et c'est le role du compilateur) , 
c'est que le mot age dans votre programme est remplace par l'adresse 4655 a l'execution. 
Cela fait que, a chaque fois que vous avez tape le mot age dans votre code source, il est 
remplace par 4655, et votre ordinateur voit ainsi a quelle adresse il doit aller chercher 
en memoire ! Du coup, l'ordinateur se rend en memoire a l'adresse 4655 et repond 
fierement : « La variable age vaut 10 ! ». 




1. Le vocabulaire est tres important, retenez-le. 

2. Le nombre d'adresses disponibles depend en fait de la quantite de memoire dont dispose votre 
ordinateur. 
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CHAPITRE 11. A L'ASSAUT PES POINTEURS 

On sait done comment recuperer la valeur de la variable : il suffit tout betement de 
taper age dans son code source. Si on veut afficher l'age, on peut utiliser la fonction 
printf : 

I printf ("La variable age vaut : '/,d" , age); 

Resultat a l'ecran : 



La variable age vaut : 10 



Rien de bien nouveau j usque-la. 

Le scoop du jour 

On sait afficher la valeur de la variable, mais saviez-vous que l'on peut aussi afficher 
l'adresse correspondante ? 

Pour afficher l'adresse de la variable, on doit utiliser le symbole °/„p (le p du mot « poin- 
teur ») dans le printf. En outre, on doit envoyer a la fonction printf non pas la 
variable age, mais son adresse. . . Et pour faire cela, vous devez mettre le symbole & 
devant la variable age, comme je vous avais demande de le faire pour les scanf , il y a 
quelque temps, sans vous expliquer pourquoi. 

Tapez done : 

I printf ("L'adresse de la variable age est : '/,p" , &age) ; 

Resultat : 



L'adresse de la variable age est : 0023FF74 



Ce que vous voyez la est l'adresse de la variable age au moment ou j'ai lance le pro- 
gramme sur mon ordinateur. Oui, oui, 0023FF74 est un nombre, il est simplement ecrit 
dans le systeme hexadecimal, au lieu du systeme decimal dont nous avons l'habitude. 
Si vous remplacez °/,p par °/,d, vous obtiendrez un nombre decimal que vous connaissez. 

Si vous executez ce programme sur votre ordinateur, l'adresse sera tres cer- 
tainement differente. Tout depend de la place que vous avez en memoire, 
des programmes que vous avez lances, etc. II est totalement impossible de 
predire a quelle adresse la variable sera stockee chez vous. Si vous lancez 
votre programme plusieurs fois d'affilee, il se peut que l'adresse soit iden- 
tique, la memoire n'ayant pas beaucoup change entre temps. Si par contre 
vous redemarrez votre ordinateur, vous aurez surement une valeur differente. 
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Ou je veux en venir avec tout ga? Eh bien en fait, je veux vous faire retenir ceci 

- age : designe la valeur de la variable ; 

- &age : designe l'adresse de la variable. 
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Avec age, l'ordinateur va lire la valeur de la variable en memoire et vous renvoie cette 
valeur. Avec feage, votre ordinateur vous dit en revanche a quelle adresse se trouve la 
variable. 



Utiliser des pointeurs 

Jusqu'ici, nous avons uniquement cree des variables faites pour contenir des nombres. 
Maintenant, nous allons apprendre a creer des variables faites pour contenir des adresses 
ce sont justement ce qu'on appelle des pointeurs. 

Mais. . . Les adresses sont des nombres aussi, non ? Ca revient a stocker des 
V nombres encore et toujours ! 



C'est exact. Mais ces nombres auront une signification particuliere : ils indiqueront 
l'adresse d'une autre variable en memoire. 



Creer un pointeur 

Pour creer une variable de type pointeur, on doit rajouter le symbole * devant le nom 
de la variable. 




I int *monPointeur ; 
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Notez qu'on peut aussi ecrire. . . 

int* monPointeur; 

Cela revient exactement au meme. Cependant, la premiere methode est a 
preferer. En effet, si vous voulez declarer plusieurs pointeurs sur la meme 
ligne, vous serez obliges de mettre I'etoile devant le nom : 

int *pointeurl, *pointeur2, *pointeur3; 



Comme je vous l'ai appris, il est important d'initialiser des le debut ses variables, en 
leur donnant la valeur par exemple. C'est encore plus important de le faire avec les 
pointeurs ! Pour initialiser un pointeur, c'est-a-dire lui donner une valeur par defaut, 
on n 'utilise generalement pas le nombre mais le mot-cle NULL 3 : 

I int *monPointeur = MULL; 

La, vous avez un pointeur initialise a NULL. Comme ga, vous saurez dans la suite de 
votre programme que votre pointeur ne contient aucune adresse. 



3. Veillez a Fecrire en majuscules. 
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CHAPITRE 11. A L'ASSAUT PES POINTEURS 

Que se passe-t-il ? Ce code va reserver une case en memoire comme si vous aviez cree 
une variable normale. Cependant, et c'est ce qui change, la valeur du pointeur est faite 
pour contenir une adresse. L'adresse. . . d'une autre variable. 

Pourquoi pas l'adresse de la variable age ? Vous savez maintenant comment indiquer 
l'adresse d'une variable au lieu de sa valeur (en utilisant le symbole ft), alors allons-y ! 
Qa, nous donne : 

int age = 10; 

int *pointeurSurAge = &age; 

La premiere ligne signifie : « Creer une variable de type int dont la valeur vaut 10 ». 
La seconde ligne signifie : « Creer une variable de type pointeur dont la valeur vaut 
l'adresse de la variable age ». 

La seconde ligne fait done deux choses a la fois. Si vous le souhaitez, pour ne pas tout 
melanger, sachez qu'on peut la decouper en deux temps : 

int age = 10; 

int *pointeurSurAge; // 1) signifie "Je cree un pointeur" 

pointeurSurAge = ftage; // 2) signifie "pointeurSurAge contient l'adresse de la 

<— >• variable age" 

Vous avez remarque qu'il n'y a pas de type « pointeur » comme il y a un type int et 
un type double. On n'ecrit done pas : 

I pointeur pointeurSurAge; 

Au lieu de ga, on utilise le symbole *, mais on continue a ecrire int. Qu'est-ce que ga 
signifie? En fait, on doit indiquer quel est le type de la variable dont le pointeur va 
contenir l'adresse. Comme notre pointeur pointeurSurAge va contenir l'adresse de la 
variable age (qui est de type int), alors mon pointeur doit etre de type int* ! Si ma 
variable age avait ete de type double, alors j'aurais du ecrire double *monPointeur. 

Vocabulaire : on dit que le pointeur pointeurSurAge pointe sur la variable age. 

La fig. 11.2 resume ce qu'il s'est passe dans la memoire. 

Dans ce schema, la variable age a ete placee a l'adresse 177450 (vous voyez d'ailleurs 
que sa valeur est 10), et le pointeur pointeurSurAge a ete place a l'adresse 3 (c'est 
tout a fait le fruit du hasard) . 

Lorsque mon pointeur est cree, le systeme d'exploitation reserve une case en memoire 
comme il l'a fait pour age. La difference ici, c'est que la valeur de pointeurSurAge est 
un peu particuliere. Regardez bien le schema : c'est l'adresse de la variable age ! 

Ceci, chers lecteurs, est le secret absolu de tout programme ecrit en langage C. On y 
est, nous venons de rentrer dans le monde merveilleux des pointeurs ! 




<? 



Et. . . ca sert a quoi ? 



150 



UTILISER DES POINTEURS 



Adresse 



pointeurSurAge 



age 



177450 



Valeur 



145 



82 



177450 




10 



3 448 765 900 126 
(et des poussieres) 



940 



Figure 11.2 - Memoire, adresses et pointeurs 
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CHAPITRE 11. A L'ASSAUT PES POINTEURS 

Ca ne transforme pas encore votre ordinateur en machine a cafe, certes. Seulement 
maintenant, on a un pointeurSurAge qui contient l'adresse de la variable age. Essayons 
de voir ce que contient le pointeur a l'aide d'un printf : 

int age = 10; 

int *pointeurSurAge = &age; 

printf ("*/,d" , pointeurSurAge) ; 



177450 



Hum. En fait, cela n'est pas tres etonnant. On demande la valeur de pointeurSurAge, 
et sa valeur c'est l'adresse de la variable age (177450). Comment faire pour demander 
a avoir la valeur de la variable se trouvant a l'adresse indiquee dans pointeurSurAge ? 
II faut placer le symbole * devant le nom du pointeur : 

int age = 10; 

int *pointeurSurAge = &age; 

printf ("*/,d" , ^pointeurSurAge) ; 

Hourra ! Nous y sommes arrives ! En plagant le symbole * devant le nom du pointeur, 
on accede a la valeur de la variable age. 

Si au contraire on avait utilise le symbole & devant le nom du pointeur, on aurait obtenu 
l'adresse a laquelle se trouve le pointeur (ici, c'est 3). 

Qu'est-ce qu'on y gagne? On a simplement reussi a compliquer les choses 
) ici. On n'avait pas besoin d'un pointeur pour afficher la valeur de la variable 




age! 

Cette question (que vous devez inevitablement vous poser) est legitime. Apres tout, qui 
pourrait vous en vouloir? Actuellement l'interet n'est pas evident, mais petit a petit, 
tout au long des chapitres suivants, vous comprendrez que tout cela n'a pas ete invente 
par pur plaisir de compliquer les choses. 

Faites l'impasse sur la frustration que vous devez ressentir (« Tout qa pour ga? »). Si 
vous avez compris le principe, c'est l'essentiel. Les choses s'eclairciront d'elles-memes 
par la suite. 

A retenir absolument 

Void ce qu'il faut avoir compris et ce qu'il faut retenir pour la suite de ce chapitre : 
- sur une variable, comme la variable age : 
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- age signifie : « Je veux la valeur de la variable age », 

- &age signifie : « Je veux l'adresse a laquelle se trouve la variable age » ; 
- sur un pointeur, comme pointeurSurAge : 

- pointeurSurAge signifie : « Je veux la valeur de pointeurSurAge » (cette valeur 
etant une adresse), 

- *pointeurSurAge signifie : « Je veux la valeur de la variable qui se trouve a 
l'adresse contenue dans pointeurSurAge ». 

Contentez-vous de bien retenir ces quatre points. Faites des tests et verifiez que ga 
marche. Le schema de la fig. 11.3 devrait bien vous aider a situer chacun de ces elements. 



Adresse 



Valeur 



177450 

&age 



145 



82 



177450 

pointeurSurAge 




10 

age 

'pointeurSurAge 



3 443 765 900 126 
(et des poussieres) 



940 



Figure 11.3 - Designation des variables et pointeurs 
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CHAPITRE 11. A L'ASSAUT DES POINTEURS 

Attention a ne pas confondre les differentes significations de I'etoile ! Lorsque 
vous declarez un pointeur, I'etoile sert juste a indiquer qu'on veut creer un 
pointeur : 



A 



int *pointeurSurAge; 

En revanche, lorsqu'ensuite vous utilisez votre pointeur en ecrivant : 

printf ("*/,d" , *pointeurSurAge) ; 

. . . cela ne signifie pas « Je veux creer un pointeur » mais : « Je veux la 
valeur de la variable sur laquelle pointe mon pointeurSurAge ». 

Tout cela est fon-da-men-tal. II faut connaitre cela par cceur et surtout le comprendre. 
N'hesitez pas a lire et relire ce qu'on vient d'apprendre. Je ne peux pas vous en vouloir si 
vous n'avez pas compris du premier coup et ce n'est pas une honte non plus, d'ailleurs. 
II faut en general quelques jours pour bien comprendre et souvent quelques mois pour 
en saisir toutes les subtilites. 

Si vous vous sentez un peu perdus, pensez a ces gens qui sont aujourd'hui de grands 
gourous de la programmation : aucun d'entre eux n'a compris tout le fonctionnement 
des pointeurs du premier coup. Et si jamais cette personne existe, il faudra vraiment 
me la presenter. 

Envoyer un pointeur a une fonction 

Le gros interet des pointeurs (mais ce n'est pas le seul) est qu'on peut les envoyer a des 
fonctions pour qu'ils modifient directement une variable en memoire, et non une copie 
comme on l'a vu. 

Comment ca marche ? II y a en fait plusieurs facons de faire. Voici un premier exemple : 

void triplePointeur(int *pointeurSurNombre) ; 

int main(int argc, char *argv[]) 
{ 

int nombre = 5 ; 

triplePointeur (ftnombre) ; // On envoie l'adresse de nombre a la fonction 
printf ("*/,d" , nombre); // On affiche la variable nombre. La fonction a 

«-> directement modifie la valeur de la variable car elle connaissait son 

c — ¥ adresse 

return 0; 



void triplePointeur(int *pointeurSurNombre) 
{ 

*pointeurSurNombre *= 3; // On multiplie par 3 la valeur de nombre 
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l> 

> ( Code web : 265254 ) 



15 



La fonction triplePointeur prend un parametre de type int* (c'est-a-dire un pointeur 
sur int). Voici ce qu'il se passe dans l'ordre, en partant du debut du main : 

1. une variable nombre est creee dans le main. On lui affecte la valeur 5. Ca, vous 
connaissez ; 

2. on appelle la fonction triplePointeur. On lui envoie en parametre l'adresse de 
notre variable nombre ; 

3. la fonction triplePointeur regoit cette adresse dans pointeurSurNombre. A l'in- 
terieur de la fonction triplePointeur, on a done un pointeur pointeurSurNombre 
qui contient l'adresse de la variable nombre ; 

4. maintenant qu'on a un pointeur sur nombre, on peut modifier directement la 
variable nombre en memoire! II suffit d'utiliser *pointeurSurNombre pour desi- 
gner la variable nombre ! Pour l'exemple, on fait un simple test : on multiplie la 
variable nombre par 3 ; 

5. de retour dans la fonction main, notre nombre vaut maintenant 15 car la fonction 
triplePointeur a modifie directement la valeur de nombre. 

Bien sur, j'aurais pu faire un simple return comme on a appris a le faire dans le 
chapitre sur les fonctions. Mais l'interet, la, e'est que de cette maniere, en utilisant des 
pointeurs, on peut modifier la valeur de plusieurs variables en memoire (on peut done 
« renvoyer plusieurs valeurs »). Nous ne sommes plus limites a une seule valeur! 

Quel est l'interet maintenant d'utiliser un return dans une fonction si on 
V peut se servir des pointeurs pour modifier des valeurs? 



Ca dependra de vous et de votre programme. C'est a vous de decider. II faut savoir que 
les return sont bel et bien toujours utilises en C. Le plus souvent, on s'en sert pour 
renvoyer ce qu'on appelle un code d'erreur : la fonction renvoie 1 (vrai) si tout s'est 
bien passe, et (faux) s'il y a eu une erreur pendant le deroulement de la fonction. 

Une autre facon d'envoyer un pointeur a une fonction 

Dans le code source qu'on vient de voir, il n'y avait pas de pointeur dans la fonction 
main. Juste une variable nombre. Le seul pointeur qu'il y avait vraiment etait dans la 
fonction tripleNombre (de type int*). 

II faut absolument que vous sachiez qu'il y a une autre facon d'ecrire le code precedent, 
en ajoutant un pointeur dans la fonction main : 
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void triplePointeur(int *pointeurSurNombre) ; 

int main(int argc, char *argv[]) 
{ 

int nombre = 5 ; 

int *pointeur = ftnombre; // pointeur prend l'adresse de nombre 

triplePointeur (pointeur) ; // On envoie pointeur (l'adresse de nombre) a la 
<—} fonction 

printf ("'/id" , *pointeur) ; // On affiche la valeur de nombre avec *pointeur 

return 0; 



void triplePointeur(int *pointeurSurNombre) 
{ 

*pointeurSurNombre *= 3; // On multiplie par 3 la valeur de nombre 
} 



Code web : 391317 



Comparez bien ce code source avec le precedent. II y a de subtiles differences et pourtant 
le resultat est strictement le mtae : 

I 

Ce qui compte, c'est d'envoyer l'adresse de la variable nombre a la fonction. Or, 
pointeur vaut l'adresse de la variable nombre, done c'est bon de ce cote! On le fait 
seulement d'une maniere differente en creant un pointeur dans la fonction main. Dans 
le printf (et c'est juste pour l'exercice), j'affiche le contenu de la variable nombre en 
tapant *pointeur. Notez qu'a la place, j'aurais pu ecrire nombre : le resultat aurait 
ete identique car *pointeur ct nombre designent la meme chose dans la memoire. 

Dans le programme « Plus ou Moins », nous avons utilise des pointeurs sans vraiment 
le savoir. C'etait en fait en appelant la fonction scanf . En effet, cette fonction a pour 
role de lire ce que l'utilisateur a entre au clavier et de renvoyer le resultat. Pour que 
la fonction puisse modifier directement le contenu de votre variable afin d'y placer la 
valeur tapee au clavier, elle a besoin de l'adresse de la variable : 

int nombre = 0; 
scanf C'/.d" , ftnombre) ; 

La fonction travaille avec un pointeur sur la variable nombre et peut ainsi modifier 
directement le contenu de nombre. Comme on vient de le voir, on pourrait creer un 
pointeur qu'on enverrait a la fonction scanf : 

int nombre = 0; 

int *pointeur = ftnombre; 

scanf ("*/,d" , pointeur); 
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QUI A PIT : « UN PROBLEME BIEN ENNUYEUX » ? 

Attention a ne pas mettre le symbole & devant pointeur dans la fonction scanf ! Ici, 
pointeur contient lui-meme l'adresse de la variable nombre, pas besoin de mettre un & ! 
Si vous faisiez ga, vous enverriez l'adresse ou se trouve le pointeur : or c'est de l'adresse 
de nombre dont on a besoin. 



Qui a dit : « Un probleme bien ennuyeux » ? 

Le chapitre est sur le point de s'achever, il est temps de retrouver notre fil rouge. 
Si vous avez compris ce chapitre, vous devriez §tre capables de resoudre le probleme, 
maintenant. Qu'est-ce que vous en dites ? Essayez ! 

Voici la solution pour comparer : 

void decoupeMinutes (int* pointeurHeures , int* pointeurMinutes) ; 

int main (int argc, char *argv[]) 
{ 

int heures = 0, minutes = 90; 

// On envoie l'adresse de heures et minutes 
decoupeMinutes (ftheures , &minutes) ; 

// Cette fois, les valeurs ont ete modifiees ! 
printf("'/,d heures et */,d minutes", heures, minutes); 

return ; 



void decoupeMinutes (int* pointeurHeures, int* pointeurMinutes) 

{ 

/* Attention a ne pas oublier de mettre une etoile devant le nom 

des pointeurs ! Comme $a, vous pouvez modifier la valeur des variables, 

et non leur adresse ! Vous ne voudriez pas diviser des adresses, 

n'est-ce pas ? ;o) */ 

*pointeurHeures = *pointeurMinutes / 60; 

*pointeurMinutes = *pointeurMinutes '/, 60; 

} 



> Code web : 423083 



Resultat : 



1 heures et 30 minutes 



Rien ne devrait vous surprendre dans ce code source. Toutefois, comme on n'est jamais 
trop prudent, je vais rabacher une fois de plus ce qui se passe dans ce code afin d'etre 
certain que tout le monde me suit bien 4 . 



4. C'est un chapitre important, vous devez faire beaucoup d'efforts pour comprendre : je peux done 
bien en faire moi aussi pour vous. 
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1. Les variables heures et minutes sont creees dans le main. 

2. On envoie a la fonction decoupeMinutes l'adresse de heures et minutes. 

3. La fonction decoupeMinutes recupere ces adresses dans des pointeurs appeles 
point eurHeures et pointeurMinutes. Notez que la encore, le nom importe peu. 
J'aurais pu les appeler h et m, ou meme encore heures et minutes 5 . 

4. La fonction decoupeMinutes modifie directement les valeurs des variables heures 
et minutes en memoire car elle possede leurs adresses dans des pointeurs. La seule 
contrainte, un peu genante je dois le reconnaitre, c'est qu'il faut imperativement 
mettre une etoile devant le nom des pointeurs si on veut modifier la valeur de 
heures et de minutes. Si on n'avait pas fait ca, on aurait modifie l'adresse conte- 
nue dans les pointeurs, ce qui n'aurait servi. . . a rien. 

De nombreux lecteurs m'ont fait remarquer qu'il etait possible de resoudre le 
« probleme » sans utiliser de pointeurs. Oui, bien sur c'est possible, mais il 
faut contourner certaines regies que nous nous sommes fixees : on peut utiliser 
des variables globales (mais on I'a dit, c'est mal), ou encore faire un printf 
dans la fonction decoupeMinutes (alors que c'est dans le main qu'on veut 
faire le printf !). L'exercice est un peu scolaire et peut done etre contourne 
si vous etes malins, ce qui vous fait peut-etre douter de I'interet des pointeurs. 
Soyez assures que cet interet vous paraTtra de plus en plus evident au cours 
des chapitres suivants. 



En resume 

- Chaque variable est stockee a une adresse precise en memoire. 

- Les pointeurs sont semblables aux variables, a ceci pres qu'au lieu de stocker un 
nombre ils stockent l'adresse a laquelle se trouve une variable en memoire. 

- Si on place un symbole & devant un nom de variable, on obtient son adresse au lieu 
de sa valeur (ex. : feage). 

- Si on place un symbole * devant un nom de pointeur, on obtient la valeur de la 
variable stockee a l'adresse indiquee par le pointeur. 

- Les pointeurs constituent une notion essentielle du langage C, mais neanmoins un 
peu complexe au debut. II faut prendre le temps de bien comprendre comment ils 
fonctionnent car beaucoup d'autres notions sont basees dessus. 




a 



5. Je ne l'ai pas fait car je ne veux pas que vous risquiez de confondre avec les variables heures et 
minutes du main, qui ne sont pas les memes. 
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Chapitre 



12 



Les tableaux 



Ce chapitre est la suite directe des pointeurs et va vous faire comprendre un peu plus 
leur utilite. Vous comptiez y echapper? C'est rate I Les pointeurs sont partout en C, 
vous avez ete prevenus I 

Dans ce chapitre, nous apprendrons a creer des variables de type « tableaux ». Les tableaux 
sont tres utilises en C car ils sont vraiment pratiques pour organiser une serie de valeurs. 

Nous commencerons dans un premier temps par quelques explications sur le fonctionnement 
des tableaux en memoire (schemas a I'appui). Ces petites introductions sur la memoire sont 
extremement importantes : elles vous permettent de comprendre comment cela fonctionne. 
Un programmeur qui comprend ce qu'il fait, c'est quand meme un peu plus rassurant pour 
la stabilite de ses programmes, non ? ;-) 




159 



CHAPITRE 12. LES TABLEAUX 



Les tableaux dans la memoire 

« Les tableaux sont une suite de variables de meme type, situees dans un espace contigu 
en memoire. » 

Bon, je reconnais que ga ressemble un peu a une definition du dictionnaire. Concrete- 
ment, il s'agit de « grosses variables » pouvant contenir plusieurs nombres du meme 
type (long, int, char, double...). 

Un tableau a une dimension bien precise. II peut occuper 2, 3, 10, 150, 2 500 cases, 
c'est vous qui decidez. La fig. 12.1 est un schema d'un tableau de 4 cases en memoire 
qui commence a l'adresse 1600. 



Adresse 



1600 



1601 



1602 



1603 



Valour 



10 



23 



505 



Figure 12.1 - Un tableau de 4 cases 

Lorsque vous demandez a creer un tableau de 4 cases en memoire, votre programme 
demande a l'OS la permission d'utiliser 4 cases en memoire. Ces 4 cases doivent etre 
contigues, c'est-a-dire les unes a la suite des autres. Comme vous le voyez, les adresses 
se suivent : 1600, 1601, 1602, 1603. II n'y a pas de « trou » au milieu. 

Enfin, chaque case du tableau contient un nombre du meme type. Si le tableau est de 
type int, alors chaque case du tableau contiendra un int. On ne peut pas faire de 
tableau contenant a la fois des int et des double par exemple. 

En resume, voici ce qu'il faut retenir sur les tableaux. 

- Lorsqu'un tableau est cree, il prend un espace contigu en memoire : les cases sont 
les unes a la suite des autres. 

- Toutes les cases d'un tableau sont du meme type. Ainsi, un tableau de int contiendra 
uniquement des int, et pas autre chose. 

Definir un tableau 



Pour commencer, nous allons voir comment definir un tableau de 4 int 
I int tableau [4] ; 
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DEFINIR UN TABLEAU 



Voila, c'est tout. II suffit done de rajouter entre crochets le nombre de cases que vous 
voulez mettre dans votre tableau. II n'y a pas de limite 1 . 

Maintenant, comment acceder a chaque case du tableau? C'est simple, il faut ecrire 
tableau [numeroDeLaCase] . 
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Attention : un tableau commence a I'indice n°0 ! Notre tableau de 4 int a 
done les indices 0, 1, 2 et 3. II n'y a pas d'indice 4 dans un tableau de 4 
cases I C'est une source d'erreurs tres courantes, souvenez-vous-en. 



Si je veux mettre dans mon tableau les memes valeurs que celles indiquees sur la fig 
12.1, je devrai done ecrire : 

int tableau [4] ; 

tableau [0] = 10; 

tableau [1] = 23; 

tableau [2] = 505; 

tableau [3] = 8; 



H Je ne vois pas le rapport entre les tableaux et les pointeurs? 




O 



En fait, si vous ecrivez juste tableau, vous obtenez un pointeur. C'est un pointeur sur 
la premiere case du tableau. Faites le test : 

int tableau [4] ; 
printf ("*/,d" , tableau); 

Resultat, on voit l'adresse ou se trouve tableau : 
1600 ^ 

En revanche, si vous indiquez I'indice de la case du tableau entre crochets, vous obtenez 
la valeur : 

int tableau [4] ; 

printf ("*/,d" , tableau[0] ) ; 



10 



De meme pour les autres indices. Notez que comme tableau est un pointeur, on peut 
utiliser le symbole * pour connaitre la premiere valeur : 



1. A part peut-etre la taille de votre memoire, quand meme. 
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int tableau [4] ; 

printf ("*/,d" , ^tableau) ; 



10 



II est aussi possible d'obtenir la valeur de la seconde case avec * (tableau +1) (adresse 
de tableau + 1). Les deux lignes suivantes sont done identiques : 

tableau[l] // Renvoie la valeur de la seconde case (la premiere case etant 0) 
♦(tableau + 1) // Identique : renvoie la valeur contenue dans la seconde case 



En clair, quand vous ecrivez tableau [0], vous demandez la valeur qui se trouve a 
l'adresse tableau + case (e'est-a-dire 1600). Si vous ecrivez tableau[l], vous de- 
mandez la valeur se trouvant a l'adresse tableau + 1 case (e'est-a-dire 1601). Et ainsi 
de suite pour les autres valeurs. 

Les tableaux a taille dynamique 

Le langage C existe en plusieurs versions. Une version recente, appelee le C99, autorise 
la creation de tableaux a taille dynamique, e'est-a-dire de tableaux dont la taille est 
definie par une variable : 

int taille = 5; 

int tableau [taille] ; 

Or cela n'est pas forcement reconnu par tous les compilateurs, certains planteront sur 
la seconde ligne. Le langage C que je vous enseigne depuis le debut (appele le C89) 
n'autorise pas ce genre de choses. Nous considererons done que faire cela est interdit. 

Nous allons nous mettre d'accord sur ceci : vous n'avez pas le droit d'utiliser une 
variable entre crochets pour la definition de la taille du tableau, meme si cette variable 
est une constante ! Le tableau doit avoir une dimension fixe, e'est-a-dire que vous devez 
ecrire noir sur blanc le nombre correspondant a la taille du tableau : 




I int tableau [5] ; 



^k Mais alors. . . il est interdit de creer un tableau dont la taille depend d'une 
variable? 



Non, rassurez-vous : e'est possible, meme en C89. Mais pour faire cela, nous utiliserons 
une autre technique (plus sure et qui marche partout) appelee l'allocation dyna- 
mique. Nous verrons cela bien plus loin dans ce cours. 
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Parcourir un tableau 



Supposons que je veuille maintenant afficher les valeurs de chaque case du tableau. 
Je pourrais faire autant de printf qu'il y a de cases. Mais bon, ce serait repetitif et 
lourd 2 . 

Le mieux est de se servir d'une boucle. Pourquoi pas d'une boucle for? Les boucles 
for sont tres pratiques pour parcourir un tableau : 



int main(int argc, char *argv[]) 
{ 

int tableau [4] , i = 0; 

tableau [0] = 10; 

tableau [1] = 23; 

tableau [2] = 505; 

tableau [3] = 8; 

for (i = ; i < 4 ; i++) 
{ 

printf ("*/,d\n" , tableau[i] ) ; 
} 

return ; 



D> ( Code web : 912292 ) 




Notre boucle parcourt le tableau a l'aide d'une variable appelee i (c'est le nom tres 
original que les programmeurs donnent en general a la variable qui leur permet de 
parcourir un tableau !). 

Ce qui est particulierement pratique, c'est qu'on peut mettre une variable entre cro- 
chets. En effet, la variable etait interdite pour la creation du tableau (pour definir sa 
taille), mais elle est heureusement autorisee pour « parcourir » le tableau, c'est-a-dire 
afficher ses valeurs ! Ici, on a mis la variable i, qui vaut successivement 0, 1, 2, et 3. De 
cette fagon, on va done afRcher la valeur de tableau [0], tableau [1], tableau [2] ct 
tableau [3] ! 



2. Imaginez un peu la taille de notre code si on devait afficher le contenu de chaque case du tableau 
une a une ! 
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Attention a ne pas tenter d'afficher la valeur de tableau [4] ! Un tableau 
de 4 cases possede les indices 0, 1, 2 et 3, point barre. Si vous tentez d'affi- 
cher tableau[4], vous aurez soit n'importe quoi, soit une belle erreur, I'OS 
coupant votre programme car il aura tente d'acceder a une adresse ne lui 
appartenant pas. 
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Initialiser un tableau 

Maintenant que l'on sait parcourir un tableau, nous sommes capables d'initialiser toutes 
ses valeurs a en faisant une boucle ! 

Bon, parcourir le tableau pour mettre a chaque case, c'est de votre niveau maintenant : 

int main(int argc, char *argv[]) 
{ 

int tableau [4] , i = 0; 

// Initialisation du tableau 
for (i = ; i < 4 ; i++) 
{ 

tableau [i] = 0; 
} 

// Affichage de ses valeurs pour verifier 

for (i = ; i < 4 ; i++) 

{ 

printf ("*/,d\n" , tableau[i]); 
} 



return 0; 



} 



t> ( Code web : 157889 




Une autre fagon d'initialiser 

II faut savoir qu'il existe une autre facon d'initialiser un tableau un peu plus automatisee 
en C. Elle consiste a ecrire tableau [4] = {valeur 1, valeur2, valeur3, valeur4}. 
En clair, vous placez les valeurs une a une entre accolades, separees par des virgules : 

int main(int argc, char *argv[]) 
{ 
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int tableau[4] = {0, 0, 0, 0}, i = 0; 

for (i = ; i < 4 ; i++) 
{ 

printf ("*/,d\n" , tableau[i] ) ; 
} 

return ; 



} 




Mais en fait, c'est mtae mieux que ga : vous pouvez definir les valeurs des premieres 
cases du tableau, toutes celles que vous n'aurez pas renseignees seront automatiquement 
mises a 0. 

Ainsi, si je fais : 

| int tableau [4] = {10, 23}; // Valeurs inserees : 10, 23, 0, 

... la case n°0 prendra la valeur 10, la n°l prendra 23, et toutes les autres prendront 
la valeur (par defaut). 

Comment initialiser tout le tableau a en sachant ga ? Eh bien il vous suffit d'initialiser 
au moins la premiere valeur a 0, et toutes les autres valeurs non indiquees prendront 
la valeur 0. 

I int tableau [4] = {0}; // Toutes les cases du tableau seront initialisees a 

Cette technique a l'avantage de fonctionner avec un tableau de n'importe quelle taille 
(la, ga marche pour 4 cases, mais s'il en avait eu 100 ga aurait ete bon aussi). 
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Attention, on rencontre souvent : 

int tableau [4] = {1}; // Valeurs inserees : 1, 0, 0, 

Contrairement a ce que beaucoup d'entre vous semblent croire, on n'initialise 
pas toutes les cases a 1 en faisant cela : seule la premiere case sera a 1, 
les autres seront a 0. On ne peut done pas initialiser toutes les cases a 1 
automatiquement, a moins de faire une boucle. 



Passage de tableaux a une fonction 

Vous aurez a coup sur souvent besoin d'afficher tout le contenu de votre tableau. 
Pourquoi ne pas ecrire une fonction qui fait ga? Qa va nous permettre de decouvrir 
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comment on envoie un tableau a une fonction (ce qui m'arrange). 

II va falloir envoyer deux informations a la fonction : le tableau (enfin, l'adresse du 
tableau) et aussi et surtout sa taille! En effet, notre fonction doit etre capable d'initia- 
liser un tableau de n'importe quelle taille. Or, dans votre fonction, vous ne connaissez 
pas la taille de votre tableau. C'est pour cela qu'il faut envoyer en plus une variable 
que vous appellerez par exemple tailleTableau. 

Comme je vous l'ai dit, tableau peut etre considere comme un pointeur. On peut done 
l'envoyer a la fonction comme on l'aurait fait avec un vulgaire pointeur : 

// Prototype de la fonction d'affichage 

void affiche(int ^tableau, int tailleTableau); 

int main(int argc, char *argv[]) 
{ 

int tableau [4] = {10, 15, 3}; 

// On affiche le contenu du tableau 
affiche (tableau, 4); 

return 0; 



void affiche (int ^tableau, int tailleTableau) 
{ 

int i; 

for (i = ; i < tailleTableau ; i++) 
{ 

printf ("*/,d\n" , tableau[i]); 
} 
} 



D> ( Code web : 571858 




La fonction n'est pas differente de celles que l'on a etudiees dans le chapitre sur les 
pointeurs. Elle prend en parametre un pointeur sur int (notre tableau), ainsi que la 
taille du tableau (tres important pour savoir quand s'arreter dans la boucle!). Tout le 
contenu du tableau est afHche par la fonction via une boucle. 

Notez qu'il existe une autre fagon d'indiquer que la fonction regoit un tableau. Plutot 
que d'indiquer que la fonction attend un int ^tableau, mettez ceci : 

I void affiche(int tableau [] , int tailleTableau) 
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Cela revient exactement au meme, mais la presence des crochets permet au program- 
meur de bien voir que c'est un tableau que la fonction prend, et non un simple pointeur. 
Cela permet d'eviter des confusions. 

J'utilise personnellement tout le temps les crochets dans mes fonctions pour bien mon- 
trer que la fonction attend un tableau. Je vous conseille de faire de meme. II n'est pas 
necessaire de mettre la taille du tableau entre les crochets cette fois. 



Quelques exercices ! 

Je ne manque pas d'idees d'exercices pour vous entrainer ! Je vous propose de realiser 
des fonctions travaillant sur des tableaux. 

Je donne juste les enonces des exercices ici pour vous forcer a reflechir a vos fonctions. 
Si vous avez du mal a realiser ces fonctions, rendez-vous sur les forums pour poser vos 
questions. 

> ( Code web : 473573 ) 



Exercice 1 

Creez une fonction sommeTableau qui renvoie la somme des valeurs contenues dans le 
tableau (utilisez un return pour renvoyer la valeur). Pour vous aider, voici le prototype 
de la fonction a creer : 

I int sommeTableau(int tableau[] , int tailleTableau) ; 

Exercice 2 

Creez une fonction moyenneTableau qui calcule et renvoie la moyenne des valeurs. 
Prototype : 

I double moyenneTableau (int tableau[] , int tailleTableau) ; 

La fonction renvoie un double car une moyenne est souvent un nombre decimal. 

Exercice 3 

Creez une fonction copierTableau qui prend en parametre deux tableaux. Le contenu 
du premier tableau devra etre copie dans le second tableau. Prototype : 

I void copie(int tableauOriginal[] , int tableauCopie [] , int tailleTableau); 

167 



CHAPITRE 12. LES TABLEAUX 



Exercice 4 

Creez une fonction maximumTableau qui aura pour role de remettre a toutes les 
cases du tableau ayant une valeur superieure a un maximum. Cette fonction prendra 
en parametres le tableau ainsi que le nombre maximum autorise (valeurMax). Toutes 
les cases qui contiennent un nombre superieur a valeurMax doivent etre mises a 0. 
Prototype : 

I void maximumTableau (int tableau [] , int tailleTableau, int valeurMax); 

Exercice 5 

Cet exercice est plus difficile. Creez une fonction ordormerTableau qui classe les valeurs 
d'un tableau dans l'ordre croissant. Ainsi, un tableau qui vaut {15, 81, 22, 13} doit 
a la fin de la fonction valoir {13, 15, 22, 81}. Prototype : 

I void ordormerTableau (int tableau[] , int tailleTableau) ; 

Cet exercice est done un peu plus difficile que les autres, mais tout a fait realisable. Ca- 
va vous occuper un petit moment. 

Faites-vous un petit fichier de fonctions appele tableaux . c (avec son homo- 
logue tableaux. h qui contiendra les prototypes, bien sur !) contenant toutes 
les fonctions de votre cru realisant des operations sur des tableaux. 




a 



Au travail ! :- 



En resume 

- Les tableaux sont des ensembles de variables du meme type stockees cote a cote en 
memoire. 

- La taille d'un tableau doit etre determinee avant la compilation, elle ne peut pas 
dependre d'une variable. 

- Chaque case d'un tableau de type int contient une variable de type int. 

- Les cases sont numerotees via des indices commengant a : tableau [0] , tableau [1] , 
tableau [2] , etc. 
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Chapitre 



13 



Les chaTnes de caracteres 



Difficulty : WB 

Une « chame de caracteres », c'est un nom programmatiquement correct pour desi- 
gner. . . du texte, tout simplement ! Une chame de caracteres, c'est done du texte que 
Ton peut retenir sous forme de variable en memoire. On pourrait ainsi stocker le nom 
de I'utilisateur. 

Comme nous I'avons dit plus tot, notre ordinateur ne peut retenir que des nombres. Les 
lettres sont exclues. Comment diable les programmeurs font-ils pour manipuler du texte, 
alors? Eh bien ils sont malins, vous allez voir! 
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Le type char 



Dans ce chapitre, nous allons porter une attention particuliere au type char. Si vous 
vous souvenez bien, le type char permet de stocker des nombres compris entre -128 et 
127. 

Si ce type char permet de stocker des nombres, il faut savoir qu'en C on 
I 'utilise rarement pour ca. En general, meme si le nombre est petit, on le 
stocke dans un int. Certes, ca prend un peu plus de place en memoire, 
mais aujourd'hui, la memoire, ce n'est vraiment pas ce qui manque sur un 
ordinateur. 
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Le type char est en fait prevu pour stocker. . . une lettre ! Attention, j'ai bien dit : UNE 
lettre. 

Comme la memoire ne peut stocker que des nombres, on a invente une table qui fait la 
conversion entre les nombres et les lettres. Cette table indique ainsi par exemple que 
le nombre 65 equivaut a la lettre A. 

Le langage C permet de faire tres facilement la traduction lettre <=> nombre cor- 
respondant. Pour obtenir le nombre associe a une lettre, il suffit d'ecrire cette lettre 
entre apostrophes, comme ceci : 'A'. A la compilation, 'A' sera remplace par la valeur 
correspondante. 

Testons : 

int main(int argc, char *argv[]) 
{ 

char lettre = 'A'; 

printf ("*/,d\n" , lettre); 

return 0; 
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On sait done que la lettre A majuscule est representee par le nombre 65. B vaut 66, C 
vaut 67, etc. Testez avec des minuscules et vous verrez que les valeurs sont differentes. 
En effet, la lettre 'a' n'est pas identique a la lettre ' A' , l'ordinateur faisant la difference 
entre les majuscules et les minuscules 1 . 

La plupart des caracteres « de base » sont codes entre les nombres et 127. Une table 
fait la conversion entre les nombres et les lettres : la table ASCII (prononcez « Aski »). 
Le site AsciiTable.com est celebre pour proposer cette table mais ce n'est pas le seul, 
on peut aussi la retrouver sur Wikipedia et bien d'autres sites encore. 

t> ( Code web : 254782 ) 



1. On dit qu'il « respecte la casse ». 
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Afficher un caractere 

La fonction printf , qui n'a decidemment pas fini de nous etonner, peut aussi afRcher 
un caractere. Pour cela, on doit utiliser le symbole °/„c (c comme caractere) : 

int main(int argc, char *argv[]) 
{ 

char lettre = 'A'; 

printf ("*/,c\n" , lettre); 

return ; 



Hourra ! Nous savons afRcher une lettre. 

On peut aussi demander a l'utilisateur d'entrer une lettre en utilisant le °/„c dans un 
scanf : 



int main (int argc, char *argv[]) 
{ 

char lettre = 0; 

scanf ("*/,c" , ftlettre) ; 
printf ("*/,c\n" , lettre); 

return ; 



} 
Si je tape la lettre B, je verrai 1 



Voici a peu pres tout ce qu'il faut savoir sur le type char. Retenez bien : 

- le type char permet de stocker des nombres allant de -128 a 127, unsigned char 
des nombres de a 255 ; 

- il y a une table que votre ordinateur utilise pour convertir les lettres en nombres et 
inversement, la table ASCII; 

- on peut done utiliser le type char pour stocker UNE lettre ; 

- 'A' est remplace a la compilation par la valeur correspondante (65 en l'occurrence). 
On utilise done les apostrophes pour obtenir la valeur d'une lettre. 



2. Le premier des deux B est celui que j'ai tape au clavier, le second est celui affiche par le printf. 
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Les chaines sont des tableaux de char 

Comme on dit, tout est dans le titre. En effet : une chaine de caracteres n'est rien 
d'autre qu'un tableau de type char. Un bete tableau de rien du tout. 

Si on cree un tableau : 

I char chaine [5] ; 

et qu'on met dans chaine [0] la lettre 'S', dans chained] la lettre 'a'... on peut 
ainsi former une chaine de caracteres, c'est-a-dire du texte. 

La fig. 13.1 vous donne une idee de la fagon dont la chaine est stockee en memoire 
(attention : je vous previens de suite, c'est un peu plus complique que ga en realite, je 
vous explique apres pourquoi). 



Adresse 



18000 



18001 



18002 



18003 



18004 



Valeur 



Figure 13.1 - Une chaine de caracteres en memoire (simplifiee) 

Comme on peut le voir, c'est un tableau qui prend 5 cases en memoire pour representer 
le mot « Salut ». Pour la valeur, j'ai volontairement ecrit sur le schema les lettres entre 
apostrophes pour indiquer que c'est un nombre qui est stocke, et non une lettre. En 
realite, dans la memoire, ce sont bel et bien les nombres correspondant a ces lettres 
qui sont stockes. 

Toutefois, une chaine de caracteres ne contient pas que des lettres ! Le schema de la fig. 
13.1 est en fait incomplet. Une chaine de caractere doit imperativement contenir 
un caractere special a la fin de la chaine, appele « caractere de fin de chaine ». 
Ce caractere s'ecrit '\0'. 
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Pourquoi faut-il que la chame de caracteres se termine par un \0 ? 
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Tout simplement pour que votre ordinateur sache quand s'arrete la chaine ! Le caractere 
\0 permet de dire : « Stop, c'est fini, y'a plus rien a lire apres, circulez ! » 

Par consequent, pour stocker le mot « Salut » (qui comprend 5 lettres) en memoire, il 
ne faut pas un tableau de 5 char, mais de 6 ! Chaque fois que vous creez une chame 
de caracteres, vous allez done devoir penser a prevoir de la place pour le caractere de 
fin de chaine. II faut toujours toujours toujours ajouter un bloc de plus dans le tableau 
pour stocker ce caractere \0, c'est imperatif ! 

Oublier le caractere de fin \0 est une source d'erreurs impitoyable du langage C. Je le 
sais pour en avoir fait les frais plus d'une fois. 

La fig. 13.2 est le schema correct de la representation de la chaine de caracteres « Salut » 
en memoire. 



Adresse 



18000 



18001 



18002 



18003 



18004 



18005 



Valeur 



Figure 13.2 - Une chaine de caracteres en memoire 

Comme vous le voyez, la chaine prend 6 caracteres et non pas 5, il va falloir s'y faire. 
La chaine se termine par '\0', le caractere de fin de chaine qui permet d'indiquer a 
l'ordinateur que la chaine se termine la. 

Voyez le caractere \0 comme un avantage. Grace a lui, vous n'aurez pas a retenir la 
taille de votre tableau car il indique que le tableau s'arrete a cet endroit. Vous pourrez 
passer votre tableau de char a une fonction sans avoir a ajouter a cfite une variable 
indiquant la taille du tableau. Cela n'est valable que pour les chaines de caracteres 
(e'est-a-dire le type char*, qu'on peut aussi ecrire char[]). Pour les autres types de 
tableaux, vous etes toujours obliges de retenir la taille du tableau quelque part. 

Creation et initialisation de la chaine 

Si on veut initialiser notre tableau chaine avec le texte « Salut », on peut utiliser la 
methode manuelle mais peu efficace : 
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char chaine [6] ; // Tableau de 6 char pour stocker S-a-1-u-t + le \0 



chaine [0] = 


>S> 




chaine [1] = 


'a' 




chaine [2] = 


'1' 




chaine [3] = 


'u' 




chaine [4] = 


't' 




chaine [5] = 


'\0 


> 



Cette methode marche. On peut le verifier avec un printf . 

Pour faire un printf il faut utiliser le symbole °/,s (s comme string, qui signifie 
« chaine » en anglais). Void le code complet qui cree une chaine « Salut » en me- 
moire et qui l'affiche : 

#include <stdio.h> 
#include <stdlib.h> 

int main(int argc, char *argv[]) 
{ 

char chaine [6] ; // Tableau de 6 char pour stocker S-a-1-u-t + le \0 

// Initialisation de la chaine (on ecrit les caracteres un a un en memoire) 

chaine [0] = ' S ' ■ 

chaine [1] = 'a' 

chaine [2] = >1> ■ 

chaine [3] = 'u' 

chaine [4] = 't'; 

chaine [5] = '\0'; 

// Affichage de la chaine grace au */,s du printf 
printf ("*/,s" , chaine); 

return 0; 



> ( Code web : 865721 ] 
Result at : 



Salut 



Vous remarquerez que c'est un peu fatigant et repetitif de devoir ecrire les caracteres 
un a un comme on l'a fait dans le tableau chaine. Pour initialiser une chaine, il existe 
heureusement une methode plus simple : 

int main(int argc, char *argv[]) 
{ 

char chaine [] = "Salut"; // La taille du tableau chaine est automatiquement 
c — ¥ calculee 
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printf ("*/,s" , chaine) ; 
return ; 

> ( Code web : 508057) 



Salut 



Comme vous le voyez a la premiere ligne, je cree une variable de type char [] . J'aurais 
pu ecrire aussi char*, le resultat aurait ete le meme. 

En tapant entre guillemets la chaine que vous voulez mettre dans votre tableau, le 
compilateur C calcule automatiquement la taille necessaire. C'est-a-dire qu'il compte 
les lettres et ajoute 1 pour placer le caractere \0. II ecrit ensuite une a une les lettres du 
mot « Salut » en memoire et ajoute le \0 comme on l'a fait nous-memes manuellement 
quelques instants plus tot. Bref, c'est bien plus pratique. 

II y a toutefois un defaut : <ja ne marche que pour l'initialisation ! Vous ne pouvez pas 
ecrire plus loin dans le code : 

| chaine = "Salut"; 

Cette technique est done a reserver a l'initialisation. Apres cela, il faudra ecrire les 
caracteres manuellement un a un en memoire comme on l'a fait au debut. 



Recuperation d'une chaine via un scanf 

Vous pouvez enregistrer une chaine entree par l'utilisateur via un scanf, en utilisant 
la encore le symbole 7„s. Seul probleme : vous ne savez pas combien de caracteres 
l'utilisateur va entrer. Si vous lui demandez son prenom, il s'appelle peut-etre Luc (3 
caracteres), mais qui vous dit qu'il ne s'appelle pas Jean-Edouard (beaucoup plus de 
caracteres) ? 

Pour ga, il n'y a pas 36 solutions. II va falloir creer un tableau de char tres grand, 
sufRsamment grand pour pouvoir stocker le prenom. On va done creer un char [100]. 
Vous avez peut-etre l'impression de gacher de la memoire, mais souvenez-vous encore 
une fois que de la place en memoire, ce n'est pas ce qui manque 3 . 

int main(int argc, char *argv[]) 
{ 

char prenom[100] ; 

printf ("Comment t 'appelles-tu petit Zero ? ") ; 

scanf ("*/,s" , prenom); 

printf ("Salut */,s, je suis heureux de te rencontrer !", prenom); 



3. Et il y a des programmes qui gachent la memoire de fagon bien pire que cela! 

175 



CHAPITRE 13. LES CHAINES DE CARACTERES 



return 0; 
} 



> [ Code web : 735780 ) 



Comment t 'appelles-tu petit Zero ? Mateo21 

Salut Mateo21, je suis heureux de te rencontrer ! 



Fonctions de manipulation des chaines 

Les chaines de caracteres sont, vous vous en doutez, frequemment utilisees. Tous les 
mots, tous les textes que vous voyez sur votre ecran sont en fait des tableaux de char 
en memoire qui fonctionnent comme je viens de vous l'expliquer. Afin de nous aider 
un peu a manipuler les chaines, on nous fournit dans la bibliotheque string. h une 
plethore de fonctions dediees aux calculs sur des chaines. 

Je ne peux pas vraiment toutes vous les presenter ici, ce serait un peu long et elles ne 
sont pas toutes indispensables. Je vais me contenter de vous parler des principales dont 
vous aurez tres certainement besoin dans peu de temps. 



Pensez a inclure string. h 

Meme si cela devrait vous paraitre evident, je prefere vous le preciser encore au cas ou : 
comme on va utiliser une nouvelle bibliotheque appelee string. h, vous devez l'inclure 
en haut des fichiers . c ou vous en avez besoin : 

I #include <string.h> 

Si vous ne le faites pas, l'ordinateur ne connaitra pas les fonctions que je vais vous 
presenter car il n'aura pas les prototypes, et la compilation plantera. En bref, n'ou- 
bliez pas d'inclure cette bibliotheque a chaque fois que vous utilisez des fonctions de 
manipulation de chaines. 

strlen : calculer la longueur d'une chaine 

strlen est une fonction qui calcule la longueur d'une chaine de caracteres (sans compter 
le caractere \0 ). Vous devez lui envoyer un seul parametre : votre chaine de caracteres. 
Cette fonction vous retourne la longueur de la chaine. 

Maintenant que vous savez ce qu'est un prototype, je vais vous donner le prototype des 
fonctions dont je vous parle. Les programmeurs s'en servent comme « mode d'emploi » 
de la fonction (mtaie si quelques explications a cote ne sont jamais superflues) : 
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a 



I size_t strlen(const char* chaine) ; 



size_t est un type special qui signifie que la fonction renvoie un nombre 
correspondant a une taille. Ce n'est pas un type de base comme int, long 
ou char, c'est un type « invente ». Nous apprendrons nous aussi a creer nos 
propres types de variables quelques chapitres plus loin. Pour le moment, on 
va se contenter de stocker la valeur renvoyee par strlen dans une variable 
de type int (I'ordinateur convertira de size_t en int automatiquement). 
En toute rigueur, il faudrait plutot stocker le resultat dans une variable de 
type size_t, mais en pratique un int est suffisant pour cela. 

La fonction prend un parametre de type const char*. Le const (qui signifie constante, 
rappelez-vous) fait que la fonction strlen « s'interdit » en quelque sorte de modifier 
votre chaine. Quand vous voyez un const, vous savez que la variable n'est pas modifiee 
par la fonction, elle est juste lue. 

Testons la fonction strlen : 

int main (int argc, char *argv[]) 
{ 

char chaine[] = "Salut"; 

int longueur Chaine = 0; 

// On recupere la longueur de la chaine dans longueur Chaine 
longueurChaine = strlen(chaine) ; 

// On affiche la longueur de la chaine 

printf("La chaine */,s fait */,d caracteres de long", chaine, longueurChaine); 

return ; 



> ( Code web : 875719 ) 



La chaine Salut fait 5 caracteres de lone 



Cette fonction strlen est d'ailleurs facile a ecrire. II suffit de faire une boucle sur 
le tableau de char qui s'arrete quand on tombe sur le caractere \0. Un compteur 
s'incremente a chaque tour de boucle, et c'est ce compteur que la fonction retourne. 

Tiens, tout ga m'a donne envie d'ecrire moi-meme une fonction similaire a strlen. Qa 
vous permettra en plus de bien comprendre comment la fonction marche : 



int longueurChaine (const char* chaine); 

int main (int argc, char *argv[]) 
{ 

char chaine[] = "Salut"; 
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int longueur = ; 

longueur = longueurChaine(chaine) ; 

printf("La chaine */,s fait */,d caracteres de long", chaine, longueur); 



return 0; 



} 



int longueurChaine (const char* chaine) 
{ 

int nombreDeCaracteres = 0; 

char caractereActuel = 0; 

do 
{ 

caractereActuel = chaine [nombreDeCaracteres] ; 

nombreDeCaracteres++ ; 
} 

while (caractereActuel != '\0'); // On boucle tant qu'on n'est pas arrive 
<->■ a l'\0 

nombreDeCaracteres--; // On retire 1 caractere de long pour ne pas compter 
M> le caractere \0 



return nombreDeCaracteres ; 



} 



> ( Code web : 150785 ) 

La fonction longueurChaine fait une boucle sur le tableau chaine. Elle stocke les 
caracteres un par un dans caractereActuel. Des que caractereActuel vaut '\0', la 
boucle s'arrete. A chaque passage dans la boucle, on ajoute 1 au nombre de caracteres 
qu'on a analyses. 

A la fin de la boucle, on retire 1 caractere au nombre total de caracteres qu'on a 
comptes. Cela permet de ne pas compter le caractere \0 dans le lot. Enfin, on retourne 
nombreDeCaracteres et le tour est joue! 

strcpy : copier une chaine dans une autre 

La fonction strcpy (comme « string copy ») permet de copier une chaine a l'interieur 
d'une autre. Son prototype est : 

I char* strcpy(char* copieDeLaChaine, const char* chaineACopier) ; 

Cette fonction prend deux parametres : 

178 



FONCTIONS DE MANIPULATION DES CHAINES 



- copieDeLaChaine : c'est un pointeur vers un char* (tableau de char). C'est dans 
ce tableau que la chaine sera copiee ; 

- chaineACopier : c'est un pointeur vers un autre tableau de char. Cette chame sera 
copiee dans copieDeLaChaine. 

La fonction renvoie un pointeur sur copieDeLaChaine, ce qui n'est pas tres utile. En 
general, on ne recupere pas ce que cette fonction renvoie. Testons cela : 



int main(int argc, char *argv[]) 

{ 

/* On cree une chaine "chaine" qui contient un peu de texte 

et une copie (vide) de taille 100 pour etre stir d'avoir la place 

pour la copie */ 

char chaine [] = "Texte", copie [100] = {0}; 

strcpy(copie, chaine); // On copie "chaine" dans "copie" 

// Si tout s'est bien passe, la copie devrait etre identique a chaine 
printf ("chaine vaut : '/,s\n" , chaine); 
printf ("copie vaut : */,s\n", copie); 

return ; 



> Code web : 193903 



chaine vaut : Texte 
copie vaut : Texte 



On voit que chaine vaut « Texte ». Jusque-la, c'est normal. Par contre, on voit aussi 
que la variable copie, qui etait vide au depart, a ete remplie par le contenu de chaine. 
La chaine a done bien ete copiee dans copie. 



A 



Verifiez que la chame copie est assez grande pour accueillir le contenu de 
chaine. Si, dans mon exemple, j'avais defini copie [5] (ce qui n'est pas 
suffisant car il n'y aurait pas eu de place pour le \0), la fonction strcpy aurait 
« deborde en memoire » et probablement fait planter votre programme. A 
eviter a tout prix, sauf si vous aimez faire planter votre ordinateur, bien sur. 



Schematiquement, la copie a fonctionne comme sur la fig. 13.3. 

Chaque caractere de chaine a ete place dans copie. La chaine copie contient de 
nombreux caracteres inutilises, vous l'aurez remarque. Je lui ai donne la taille 100 par 
securite, mais en toute rigueur, la taille 6 aurait sufHt. L'avantage de creer un tableau 
un peu plus grand, c'est que de cette fagon la chaine copie sera capable de recevoir 
d'autres chaines peut-etre plus grandes dans la suite du programme. 
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chaine 


T 


e 


X 


t 


e 


\0 






, 
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copie 
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X 


t 


e 


\0 
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Figure 13.3 - Copie d'une chaine de caracteres 

strcat : concatener 2 chaines 

Cette fonction ajoute une chaine a la suite d'une autre. On appelle cela la concatenation. 
Supposons que l'on ait les variables suivantes : 

- chaine 1 = "Salut " 

- chaine2 = "Mateo21" 

Si je concatene chaine2 dans chainel, alors chainel vaudra "Salut Mateo21". Quant 
a chaine2, elle n'aura pas change et vaudra done toujours "Mateo21". Seule chainel 
est modifiee. 

C'est exactement ce que fait strcat, dont void le prototype : 

I char* strcat (char* chainel, const char* chaine2) ; 

Comme vous pouvez le voir, chaine2 ne peut pas Stre modifiee car elle est definie 
comme constante dans le prototype de la fonction. La fonction retourne un pointeur 
vers chainel, ce qui, comme pour strcpy, ne sert pas a grand-chose dans le cas present : 
on peut done ignorer ce que la fonction nous renvoie. 

La fonction ajoute a chainel le contenu de chaine2. Regardons-y de plus pres : 



int main(int argc, char *argv[]) 

{ 

/* On cree 2 chaines. chainel doit etre assez grande pour accueillir 
le contenu de chaine2 en plus, sinon risque de plantage */ 
char chainel [100] = "Salut ", chaine2 [] = "Mateo21"; 

strcat (chainel , chaine2) ; // On concatene chaine2 dans chainel 

// Si tout s'est bien passe, chainel vaut "Salut Mateo21" 

printf ("chainel vaut : '/,s\n", chainel); 

// chaine 2 n'a pas change : 

printf ("chaine2 vaut toujours : '/,s\n", chaine2) ; 

return 0; 



> ( Code web : 220153) 
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chainel vaut : Salut Mateo21 
chaine2 vaut toujours : Mateo21 



Verifiez absolument que chainel est assez grande pour qu'on puisse lui ajouter le 
contenu de chaine2, sinon vous ferez un debordement en memoire qui peut conduire a 
un plantage. C'est pour cela que j'ai defini chainel de taille 100. Quant a chaine2, j'ai 
laisse l'ordinateur calculer sa taille (je n'ai done pas precise la taille) car cette chaine 
n'est pas modifiee, il n'y a done pas besoin de la rendre plus grande que necessaire. 

La fig. 13.4 resume le fonctionnement de la concatenation. 



chainel 


s 


a 


1 


LI 


t 




\0 


















— ■ — """ 












chaine2 


M 


a 


t 


e 





2 


1 


\0 





Figure 13.4 - Concatenation de chaines 

Le tableau chaine2 a ete ajoute a la suite de chainel (qui comprenait une centaine 
de cases). Le \0 de chainel a ete supprime (en fait, il a ete remplace par le M de 
Mateo21). En effet, il ne faut pas laisser un \0 au milieu de la chaine, sinon celle-ci 
aurait ete « coupee » au milieu ! On ne met qu'un \0 a la fin de la chaine, une fois 
qu'elle est finie. 



stremp : comparer 2 chaines 

stremp compare 2 chaines entre elles. Voici son prototype : 

lint strcmp(const char* chainel, const char* chaine2) ; 

Les variables chainel et chaine2 sont comparees. Comme vous le voyez, aucune d'elles 
n'est modifiee car elles sont indiquees comme constantes. 

II est important de recuperer ce que la fonction renvoie. En effet, stremp renvoie : 

- si les chaines sont identiques ; 

- une autre valeur (positive ou negative) si les chaines sont differentes. 




O 



II aurait ete plus logique, je le reconnais, que la fonction renvoie 1 si les chames 
avaient ete identiques pour dire « vrai » (rappelez-vous des booleens). La 
raison est simple : la fonction compare les valeurs de chacun des caracteres 
un a un. Si tous les caracteres sont identiques, elle renvoie 0. Si les caracteres 
de la chainel sont superieurs a ceux de la chaine2, la fonction renvoie 
un nombre positif. Si c'est I'inverse, la fonction renvoie un nombre negatif. 
Dans la pratique, on se sert surtout de stremp pour verifier si 2 chames sont 
identiques ou non. 



Voici un code de test : 
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int main(int argc, char *argv[]) 
{ 

char chainelG = "Texte de test", chaine2[] = "Texte de test"; 

if (strcmp(chainel, chaine2) == 0) // Si chaines identiques 
{ 

printf("Les chaines sont identiques\n") ; 
} 

else 
{ 

printf("Les chaines sont dif ferentes\n") ; 
} 



return 0; 



} 



> ( Code web : 471948 ) 



Les chaines sont identiques 



Les chaines etant identiques, la fonction strcmp a renvoye le nombre 0. Notez que 
j'aurais pu stocker ce que renvoie strcmp dans une variable de type int. Toutefois, ce 
n'est pas obligatoire, on peut directement mettre la fonction dans le if comme je l'ai 
fait. 

Je n'ai pas grand-chose a ajouter a propos de cette fonction. Elle est assez simple a 
utiliser en fait, mais il ne faut pas oublier que signifie « identique » et une autre 
valeur signifie « different ». C'est la seule source d'erreurs possible ici. 

strchr : rechercher un caractere 

La fonction strchr recherche un caractere dans une chaine. Prototype : 
I char* strchr(const char* chaine, int caractereARechercher) ; 

La fonction prend 2 parametres : 

- chaine : la chaine dans laquelle la recherche doit etre faite ; 

- caractereARechercher : le caractere que l'on doit rechercher dans la chaine. 

Vous remarquerez que caractereARechercher est de type int et non de 
type char. Ce n'est pas reellement un probleme car, au fond, un caractere 
est et restera toujours un nombre. Neanmoins, on utilise quand meme plus 
souvent un char qu'un int pour stocker un caractere en memoire. 

La fonction renvoie un pointeur vers le premier caractere qu'elle a trouve, c'est-a-dire 
qu'elle renvoie l'adresse de ce caractere dans la memoire. Elle renvoie NULL si elle n'a 
rien trouve. Dans l'exemple suivant, je recupere ce pointeur dans suiteChaine : 
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int main(int argc, char *argv[]) 
{ 

char chaine[] = "Texte de test", *suiteChaine = NULL; 

suiteChaine = strchr (chaine, 'd'); 

if (suiteChaine != NULL) // Si on a trouve quelque chose 

{ 

printf ("Voici la fin de la chaine a partir du premier d : */,s", 
<— ¥ suiteChaine) ; 

} 

return ; 



> ( Code web : 161896 ) 



Voici la fin de la chaine a partir du premier d : de test | 

Avez-vous bien compris ce qu'il se passe ici ? C'est un peu particulier. En fait, suiteChaine 
est un pointeur comme chaine, sauf que chaine pointe sur le premier caractere (le 'T' 
majuscule), tandis que suiteChaine pointe sur le premier caractere 'd' qui a ete trouve 
dans chaine. 

Le schema de la fig. 13.5 vous montre ou pointe chaque pointeur : 



T 


e 
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t 


\0 



r t 

chaine suiteChaine 

Figure 13.5 - Pointeurs et chaines 

chaine commence au debut de la chaine ('T' majuscule), tandis que suiteChaine 
pointe sur le 'd' minuscule. 

Lorsque je fais un printf de suiteChaine, il est done normal que l'on m'affiche juste 
« de test ». La fonction printf affiche tous les caracteres qu'elle rencontre ('d', 'e', ' ', 
't', 'e', 's', 't') jusqu'a ce qu'elle tombe sur le \0 qui lui dit que la chaine s'arrete la. 



Variant e 

II existe une fonction strrchr strictement identique a strchr, sauf que celle-la renvoie 
un pointeur vers le dernier caractere qu'elle a trouve dans la chaine plutot que vers 
le premier. 
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strpbrk : premier caractere de la liste 

Cette fonction ressemble beaucoup a la precedente. Celle-ci recherche un des caracteres 
dans la liste que vous lui donnez sous forme de chaine, contrairement a strchr qui ne 
peut rechercher qu'un seul caractere a la fois. 

Par exemple, si on forme la chaine "xds" et qu'on en fait une recherche dans "Texte 
de test", la fonction renvoie un pointeur vers le premier de ces caracteres qu'elle y a 
trouve. En l'occurrence, le premier caractere de "xds" qu'elle trouve dans "Texte de 
test" est le x, done strpbrk renverra un pointeur sur 'x'. 

Prototype : 

I char* strpbrk (const char* chaine, const char* lettresARechercher) ; 

Testons la fonction : 

int main(int argc, char *argv[]) 
{ 

char *suiteChaine; 

// On cherche la premiere occurrence de x, d ou s dans "Texte de test" 
suiteChaine = strpbrk ("Texte de test", "xds"); 

if (suiteChaine != NULL) 
{ 

printf ("Voici la fin de la chaine a partir du premier des caracteres 
<—} trouves : '/,s", suiteChaine); 

} 



return 0; 



} 



t> ( Code web : 866773 ) 



Voici la fin de la chaine a partir du premier des caracteres trouves : | 
xte de test I 

Pour cet exemple, j'ai directement ecrit les valeurs a envoyer a la fonction (entre guille- 
mets). Nous ne sommes en effet pas obliges d'employer une variable a tous les coups, on 
peut tres bien ecrire la chaine directement. II faut simplement retenir la regie suivante : 

- si vous utilisez les guillemets "", cela signifie chaine; 

- si vous utilisez les apostrophes ", cela signifie caractere. 

strstr : rechercher une chaine dans une autre 

Cette fonction recherche la premiere occurrence d'une chaine dans une autre chaine. 
Son prototype est : 
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I char* strstr (const char* chaine, const char* chaineARechercher) ; 

Le prototype est similaire a strpbrk, mais attention a ne pas confondre : strpbrk 
recherche UN des caracteres, tandis que strstr recherche toute la chaine. 

Exemple : 

int main(int argc, char *argv[]) 
{ 

char *suiteChaine; 

// On cherche la premiere occurrence de "test" dans "Texte de test" : 
suiteChaine = strstr ("Texte de test", "test"); 
if (suiteChaine != NULL) 
{ 

printf ("Premiere occurrence de test dans Texte de test : */,s\n", 
•-> suiteChaine) ; 
} 

return ; 
} 



> ( Code web : 293475 ) 



Premiere occurrence de test dans Texte de test : test | 

La fonction strstr recherche la chaine "test" dans "Texte de test". Elle renvoie, comme 
les autres, un pointeur quand elle a trouve ce qu'elle cherchait. Elle renvoie NULL si elle 
n'a rien trouve. 

Jusqu'ici, je me suis contente d'afficher la chaine a partir du pointeur retourne par les 
fonctions. Dans la pratique, <ja n'est pas tres utile. Vous ferez juste un if (resultat ! = 
NULL) pour savoir si la recherche a ou non donne quelque chose, et vous afficherez « Le 
texte que vous recherchiez a ete trouve ». 



sprintf : ecrire dans une chaine 



Cette fonction se trouve dans stdio.h contrairement aux autres fonctions 
que nous avons etudiees jusqu'ici, qui etaient dans string. h. 



Ce nom doit vaguement vous rappeler quelque chose. Cette fonction ressemble enor- 
mement au printf que vous connaissez mais, au lieu d'ecrire a l'ecran, sprintf ecrit 
dans. . . une chaine ! D'ou son nom d'ailleurs, qui commence par le « s » de « string » 
(chaine en anglais). 

C'est une fonction tres pratique pour mettre en forme une chaine. Petit exemple : 
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#include <stdio.h> 
#include <stdlib.h> 

int main(int argc, char *argv[]) 
{ 

char chaine [100] ; 

int age = 15; 

// On ecrit "Tu as 15 ans" dans chaine 
sprintf (chaine, "Tu as */,d ans !", age); 

// On affiche chaine pour verifier qu'elle contient bien cela : 
printf C'/.s" , chaine); 

return 0; 



> [ Code web : 279963 ) 



Tu as 15 ans ! 



Elle s'utilise de la meme maniere que printf, mis a part le fait que vous devez lui 
donner en premier parametre un pointeur vers la chaine qui doit recevoir le texte. 

Dans mon exemple, j'ecris dans chaine « Tu as %d ans », ou °/„d est remplace par 
le contenu de la variable age. Toutes les regies du printf s'appliquent, vous pouvez 
done si vous le voulez mettre des °/„s pour inserer d'autres chaines a l'interieur de votre 
chaine ! 

Comme d'habitude, verifiez que votre chaine est suffisamment grande pour accueillir 
tout le texte que le sprintf va lui envoyer. Sinon, comme on l'a vu, vous vous exposez 
a des depassements de memoire et done a un plantage de votre programme. 



En resume 

- Un ordinateur ne sait pas manipuler du texte, il ne connait que les nombres. Pour 
regler le probleme, on associe a chaque lettre de l'alphabet un nombre correspondant 
dans une table appelee la table ASCII. 

- Le type char est utilise pour stocker une et une seule lettre 4 . 

- Pour creer un mot ou une phrase, on doit construire une chaine de caracteres. 
Pour cela, on utilise un tableau de char. 

- Toute chaine de caractere se termine par un caractere special appele \0 qui signifie 
« fin de chaine ». 

- II existe de nombreuses fonctions toutes pretes de manipulation des chaines dans la 
bibliotheque string. II faut inclure string. h pour pouvoir les utiliser. 



4. II stocke en realite un nombre mais ce nombre est automatiquement traduit par l'ordinateur a 
Faffichage. 
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Chapitre 



14 



Le preprocesseur 



Difficulty : MH 

Apres ces derniers chapitres harassants sur les pointeurs, tableaux et chames de ca- 
racteres, nous allons faire une pause. Vous avez du integrer un certain nombre de 
nouveautes dans les chapitres precedents, je ne peux done pas vous refuser de souffler 

un peu. 

Ce chapitre va traiter du preprocesseur, ce programme qui s'execute juste avant la compila- 
tion. Ne vous y trompez pas : les informations contenues dans ce chapitre vous seront utiles. 
Elles sont en revanche moins complexes que ce que vous avez eu a assimiler recemment. 
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Les include 

Comme je vous l'ai explique dans les tout premiers chapitres du cours, on trouve dans 
les codes source des lignes un peu particulieres appelees directives de preproces- 
seur. Ces directives de preprocesseur ont la caracteristique suivante : elles commencent 
toujours par le symbole #. Elles sont done faciles a reconnaitre. 

La premiere (et seule) directive que nous ayons vue pour l'instant est #include. Cette 
directive permet d'inclure le contenu d'un fichier dans un autre, je vous l'ai dit plus 
tot. On s'en sert en particulier pour inclure des fichiers .h comme les fichiers .h des 
bibliotheques (stdlib.h, stdio.h, string. h, math.h. ..) et vos propres fichiers .h. 

Pour inclure un fichier .h se trouvant dans le dossier ou est installe votre IDE, vous 
devez utiliser les chevrons < > : 

I #include <stdlib.h> 

Pour inclure un fichier .h se trouvant dans le dossier de votre projet, vous devez en 
revanche utiliser les guillemets : 

I #include "monf ichier .h" 

Concretement, le preprocesseur est demarre avant la compilation. II parcourt tous vos 
fichiers a la recherche de directives de preprocesseur, ces fameuses lignes qui com- 
mencent par un #. Lorsqu'il rencontre la directive #include, il insere litteralement le 
contenu du fichier indique a l'endroit du #include. 

Supposons que j'aie un f ichier. c contenant le code de mes fonctions et un f ichier. h 
contenant les prototypes des fonctions de f ichier. c. On pourrait resumer la situation 
dans le schema de la fig. 14.1. 



i l fichier. h 
contenant les 
prototypes des 

fonctions de 
fichier.c V 



Sinclude fichier.h 



r Code source 
des fonctions *i 



fichier.h fichier.c 

Figure 14.1 - Inclusion de fichier 

Tout le contenu de fichier.h est mis a l'interieur de fichier.c, a l'endroit ou il y a 
la directive # include fichier.h. 

Imaginons qu'on ait dans le fichier.c : 



#include "fichier.h" 
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int maFonction(int true, double bidule) 
{ 

/* Code de la fonction */ 
} 

void autreFonction(int valeur) 
{ 

/* Code de la fonction */ 
} 

Et dans le f ichier.h : 

int maFonction(int true, double bidule) ; 
void autreFonction(int valeur) ; 

Lorsque le preprocesseur passe par la, juste avant la compilation de fichier.c, il 
insere f ichier.h dans fichier.c. Au final, le code source de fichier.c juste avant 
la compilation ressemble a ga : 

int maFonction(int true, double bidule) ; 
void autreFonction(int valeur) ; 

int maFonction(int true, double bidule) 
{ 

/* Code de la fonction */ 
} 

void autreFonction(int valeur) 
{ 

/* Code de la fonction */ 
} 

Le contenu du .h est venu se mettre a l'emplacement de la ligne #include. 

Ce n'est pas bien complique a comprendre, je pense d'ailleurs que bon nombre d'entre 
vous devaient se douter que <ja fonctionnait comme <ja. Avec ces explications supple- 
mentaires, j'espere avoir mis tout le monde d'accord. Le #include ne fait rien d'autre 
qu'inserer un fichier dans un autre, e'est important de bien le comprendre. 

Si on a decide de mettre les prototypes dans les .h, au lieu de tout mettre 
dans les .c, e'est essentiellement par principe. On pourrait a priori mettre les 
prototypes en haut des . c (d'ailleurs, dans certains tres petits programmes on 
le fait parfois), mais pour des questions d'organisation il est vivement conseille 
de placer ses prototypes dans des .h. Lorsque votre programme grossira et 
que plusieurs fichiers .c feront appel a un meme .h, vous serez heureux de 
ne pas avoir a copier-coller les prototypes des memes fonctions plusieurs fois I 
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Les define 

Nous allons decouvrir maintenant une nouvelle directive de preprocesseur : le #def ine. 

Cette directive permet de definir une constante de preprocesseur. Cela permet 
d'associer une valeur a un mot. Voici un exemple : 

| #def ine NOMBRE_VIES_INITIALES 3 

Vous devez ecrire dans l'ordre : 

- le #def ine ; 

- le mot auquel la valeur va etre associee ; 

- la valeur du mot. 

Attention : malgre les apparences (notamment le nom que l'on a l'habitude de mettre 
en majuscules), cela est tres different des constantes que nous avons etudiees jusqu'ici, 
telles que : 

| const int NOMBRE_VIES_INITIALES = 3; 

Les constantes occupaient de la place en memoire. Meme si la valeur ne changeait pas, 
votre nombre 3 etait stocke quelque part dans la memoire. Ce n'est pas le cas des 
constantes de preprocesseur ! 

Comment <ja fonctionne? En fait, le #def ine remplace dans votre code source tous les 
mots par leur valeur correspondante. C'est un peu comme la fonction « Rechercher / 
Remplacer » de Word si vous voulez. Ainsi, la ligne : 

| #def ine NOMBRE_VIES_INITIALES 3 

. . . remplace dans le flchier chaque NOMBRE_VIES_INITIALES par 3. 
Voici un exemple de fichier . c avant passage du preprocesseur : 

#define NOMBRE_VIES_INITIALES 3 

int main(int argc, char *argv[]) 
{ 

int vies = NOMBRE_VIES_INITIALES; 

/* Code . . .*/ 

Apres passage du preprocesseur : 

int main(int argc, char *argv[]) 
{ 

int vies = 3; 

/* Code . . .*/ 
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Avant la compilation, tous les #def ine auront done ete remplaces par les valeurs cor- 
respondantes. Le compilateur « voit » le fichier apres passage du preprocesseur, dans 
lequel tous les remplacements auront ete effectues. 

Quel interet par rapport a I'utilisation de constantes comme on I'a vu jus- 
W qu'ici? 



Eh bien, comme je vous l'ai dit, ca ne prend pas de place en memoire. C'est logique, 
vu que lors de la compilation il ne reste plus que des nombres dans le code source. 

Un autre interet est que le remplacement se fait dans tout le fichier dans lequel se 
trouve le #def ine. Si vous aviez defini une constante en memoire dans une fonction, 
celle-ci n'aurait ete valable que dans la fonction puis aurait ete supprimee. Le #def ine 
en revanche s'appliquera a toutes les fonctions du fichier, ce qui peut s'averer parfois 
pratique selon les besoins. 

Un exemple concret d'utilisation des #def ine ? En void un que vous ne tarderez pas 
a utiliser. Lorsque vous ouvrirez une fenetre en C, vous aurez probablement envie de 
definir des constantes de preprocesseur pour indiquer les dimensions de la fenetre : 

#define LARGEUR_ FENETRE 800 
#define HAUTEUR_FENETRE 600 

L'avantage est que si plus tard vous decidez de changer la taille de la fenetre (parce que 
ga vous semble trop petit), il vous suffira de modifier les #def ine puis de recompiler. 

A noter : les #def ine sont generalement places dans des .h, a cote des prototypes (vous 
pouvez d'ailleurs aller voir les .h des bibliotheques comme stdlib.h, vous verrez qu'il 
y a des #define!). Les #define sont done « faciles d'acces », vous pouvez changer les 
dimensions de la fenetre en modifiant les #def ine plutot que d'aller chercher au fond 
de vos fonctions l'endroit ou vous ouvrez la fenetre pour modifier les dimensions. C'est 
done du temps gagne pour le programmeur. 

En resume, les constantes de preprocesseur permettent de « configurer » votre pro- 
gramme avant sa compilation. C'est une sorte de mini-configuration. 



Un define pour la taille des tableaux 

On utilise souvent les define pour definir la taille des tableaux. On ecrit par exemple : 

#define TAILLE_MAX 1000 

int main(int argc, char *argv[]) 
{ 

char chainel [TAILLE_MAX] , chaine2 [TAILLE_MAX] ; 

// ... 
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Mais. . . je croyais qu'on ne pouvait pas mettre de variable ni de constante 
entre les crochets lors d'une definition de tableau ? 



Oui, mais TAILLE_MAX n'est PAS une variable ni une constante. En effet je vous l'ai 
dit, le preprocesseur transforme le fichier avant compilation en : 

int main(int argc, char *argv[]) 
{ 

char chainel[1000] , chaine2 [1000] ; 

// ... 

. . . et cela est valide ! 

En definissant TAILLE_MAX ainsi, vous pouvez vous en servir pour creer des tableaux 
d'une certaine taille. Si a l'avenir cela s'avere insuffisant, vous n'aurez qu'a modifier la 
ligne du #def ine, recompiler, et vos tableaux de char prendront tous la nouvelle taille 
que vous aurez indiquee. 



Calculs dans les define 

II est possible de faire quelques petits calculs dans les define. Par exemple, ce code 
cree une constante LARGEUR_FENETRE, une autre HAUTEUR_FENETRE, puis une troisieme 
N0MBRE_PIXELS qui contiendra le nombre de pixels affiches a l'interieur de la fenetre 
(le calcul est simple : largeur * hauteur) : 

#define LARGEUR_FENETRE 800 
#define HAUTEUR_FENETRE 600 
#define N0MBRE_PIXELS (LARGEUR_FENETRE * HAUTEUR_FENETRE) 

La valeur dc N0MBRE_PIXELS est remplacee avant la compilation par le code sui- 
vant : (LARGEUR_FENETRE * HAUTEUR_FENETRE) , c'est-a-dire par (800 * 600), ce qui 
fait 480000. Mettez toujours votre calcul entre parentheses comme je l'ai fait par secu- 
rite pour bien isoler l'operation. 

Vous pouvez faire toutes les operations de base que vous connaissez : addition (+), 
soustraction (-), multiplication (*), division (/) et modulo (%). 

Les constantes predefinies 

En plus des constantes que vous pouvez definir vous-memes, il existe quelques constantes 
predefinies par le preprocesseur. 

Chacune de ces constantes commence et se termine par deux symboles underscore _ 1 . 



1. Vous trouverez ce symbole sous le chiffre 8, tout du moins si vous avez un clavier AZERTY 
francais. II faut appuyer sur les touches Alt Gr et 8 en meme temps. 
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- LINE : donne le numero de la ligne actuelle. 

- FILE : donne le nom du fichier actuel. 

- DATE : donne la date de la compilation. 

- TIME : donne l'heure de la compilation. 

Ces constantes peuvent etre utiles pour gerer des erreurs, en faisant par exemple ceci 

printf ("Erreur a la ligne */,d du fichier */,s\n", LINE , FILE ); 

printf("Ce fichier a ete compile le '/,s a '/,s\n", DATE , TIME ); 



Erreur a la ligne 9 du fichier main.c 

Ce fichier a ete compile le Jan 13 2006 a 19:21:10 



Les definitions simples 

II est aussi possible de faire tout simplement : 

| #def ine CONSTANTE 

. . . sans preciser de valeur. Cela veut dire pour le preprocesseur que le mot CONSTANTE 
est defini, tout simplement. II n'a pas de valeur, mais il « existe ». 




J Quel peut en etre I'interet? 



O 



L'interet est moins evident que tout a l'heure, mais il y en a un et nous allons le 
decouvrir tres rapidement. 



Les macros 

Nous avons vu qu'avec le #def ine on pouvait demander au preprocesseur de remplacer 
un mot par une valeur. Par exemple : 

| #def ine NOMBRE 9 

. . . signifie que tous les NOMBRE de votre code seront remplaces par 9. Nous avons vu 
qu'il s'agissait en fait d'un simple rechercher-remplacer fait par le preprocesseur avant 
la compilation. 

J'ai du nouveau ! En fait, le #define est encore plus puissant que ga. II permet de 
remplacer aussi par... un code source tout entier! Quand on utilise #define pour 
rechercher-remplacer un mot par un code source, on dit qu'on cree une macro. 
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Macro sans parametres 

Voici un exemple de macro tres simple : 

|#define C0UC0UO printf ("Coucou") ; 

Ce qui change ici, ce sont les parentheses qu'on a ajoutees apres le mot-cle (ici COUCOU () ) 
Nous verrons a quoi elles peuvent servir tout a l'heure. 

Testons la macro dans un code source : 

#define COUCOUQ printf ("Coucou") ; 

int main(int argc, char *argv[]) 
{ 

COUCOU () 

return 0; 
} 



Coucou 



Je vous l'accorde, ce n'est pas original pour le moment. Ce qu'il faut deja bien com- 
prendre, c'est que les macros ne sont en fait que des bouts de code qui sont directement 
remplaces dans votre code source juste avant la compilation. Le code qu'on vient de 
voir ressemblera en fait a ca lors de la compilation : 

int main(int argc, char *argv[]) 
{ 

printf ("Coucou") ; 

return 0; 
} 

Si vous avez compris ca, vous avez compris le principe de base des macros. 
Mais. . . on ne peut mettre qu'une seule ligne de code par macro? 



Non, heureusement il est possible de mettre plusieurs lignes de code a la fois. II suffit 
de placer un \ avant chaque nouvelle ligne, comme ceci : 

#define RACONTER_SA_VIE() printf ("Coucou, je m'appelle Brice\n"); \ 

printf ("J 'habite a Wice\n"); \ 
printf ("J' aime la glisse\n") ; 
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int main(int argc, char *argv[]) 
{ 

RACONTER_SA_VIE() 

return ; 
} 



Coucou, 


je m'appelle 


Brice 


J 


habit 


e a Nice 




J 


aime 


la glisse 





Remarquez dans le main que l'appel de la macro ne prend pas de point-virgule a la 
fin. En effet, c'est une ligne pour le preprocesseur, elle ne necessite done pas d'etre 
terminee par un point-virgule. 



Macro avec parametres 

Pour le moment, on a vu comment faire une macro sans parametre, e'est-a-dire avec 
des parentheses vides. Le principal interet de ce type de macros, c'est de pouvoir 
« raccourcir » un code un peu long, surtout s'il est amene a etre repete de nombreuses 
fois dans votre code source. 

Cependant, les macros deviennent reellement interessantes lorsqu'on leur met des pa- 
rametres. Cela marche quasiment comme avec les fonctions. 

#define MAJEUR(age) if (age >= 18) \ 

printf ("Vous etes majeur\n"); 

int main (int argc, char *argv[]) 
{ 

MAJEUR(22) 

return ; 
} 



Vous etes majeur 



Notez qu'on aurait aussi pu ajouter un else pour afficher « Vous etes mi- 
neur ». Essayez de le faire pour vous entratner, ce n'est pas bien difficile. 
N'oubliez pas de mettre un antislash \ avant chaque nouvelle ligne. 




a 



Le principe de notre macro est assez intuitif : 

#define MAJEUR(age) if (age >= 18) \ 

printf ("Vous etes majeur\n"); 
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On met entre parentheses le nom d'une « variable » qu'on nomme age. Dans tout notre 
code de macro, age sera remplace par le nombre qui est indique lors de l'appel a la 
macro (ici, c'est 22). 

Ainsi, notre code source precedent ressemblera a ceci juste apres le passage du prepro- 
cesseur : 

int main(int argc, char *argv[]) 
{ 

if (22 >= 18) 

printf ("Vous etes majeur\n"); 

return 0; 
} 

Le code source a ete mis a la place de l'appel de la macro, et la valeur de la « variable » 
age a ete mise directement dans le code source de remplacement. 

II est possible aussi de creer une macro qui prend plusieurs parametres : 

#define MAJEUR(age, nom) if (age >= 18) \ 

printf ("Vous etes majeur '/,s\n", nom); 

int main(int argc, char *argv[]) 
{ 

MAJEUR(22, "Maxime") 

return 0; 
} 

Voila tout ce qu'on peut dire sur les macros. II faut done retenir que c'est un simple 
remplacement de code source qui a l'avantage de pouvoir prendre des parametres. 

Normalement, vous ne devriez pas avoir besoin d'utiliser tres souvent les 
macros. Toutefois, certaines bibliotheques assez complexes comme wxWidgets 
ou Qt (bibliotheques de creation de fenetres que nous etudierons bien plus 
tard) utilisent beaucoup de macros. II est done preferable de savoir comment 
cela fonctionne des maintenant pour ne pas etre perdu plus tard. 
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Les conditions 

Tenez-vous bien : il est possible de realiser des conditions en langage preprocesseur ! 
Voici comment cela fonctionne : 

#if condition 

/* Code source a compiler si la condition est vraie */ 
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#elif condition2 

/* Sinon si la condition 2 est vraie compiler ce code source */ 
#endif 



Le mot-cle #if permet d'inserer une condition de preprocesseur. #elif signifie else 
if (sinon si). La condition s'arrete lorsque vous inserez un #endif . Vous noterez qu'il 
n'y a pas d'accolades en preprocesseur. 

L'interet, c'est qu'on peut ainsi faire des compilations conditionnelles. En effet, si 
la condition est vraie, le code qui suit sera compile. Sinon, il sera tout simplement sup- 
prime du fichier le temps de la compilation. II n'apparaitra done pas dans le programme 
final. 



#ifdef , #ifndef 

Nous allons voir maintenant l'interet de faire un #def ine d'une constante sans preciser 
de valeur, comme je vous l'ai montre page 193 : 

| #def ine CONSTANTE 

En effet, il est possible d'utiliser #ifdef pour dire « Si la constante est definie ». 
#ifndef , lui, sert a dire « Si la constante n'est pas definie ». 

On peut alors imaginer ceci : 

#define WINDOWS 

#ifdef WINDOWS 

/* Code source pour Windows */ 
#endif 

#ifdef LINUX 

/* Code source pour Linux */ 
#endif 

#ifdef MAC 

/* Code source pour Mac */ 
#endif 

C'est comme <ja que font certains programmes multi-plates-formes pour s'adapter a l'OS 
par exemple. Alors, bien entendu, il faut recompiler le programme pour chaque OS (ce 
n'est pas magique). Si vous etes sous Windows, vous ecrivez un #def ine WINDOWS en 
haut, puis vous compilez. Si vous voulez compiler votre programme pour Linux (avec 
la partie du code source specifique a Linux), vous devrez alors modifier le define et 
mettre a la place : #def ine LINUX. Recompilez, et cette fois c'est la portion de code 
source pour Linux qui sera compilee, les autres parties etant ignorees. 
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#ifndef pour eviter les inclusions infinies 

#ifndef est tres utilise dans les .h pour eviter les « inclusions infinies ». 



Une inclusion infinie? C'est-a-dire? 
O 



Imaginez, c'est tres simple. J'ai un fichier A.h et un fichier B.h. Le fichier A.h contient 
un include du fichier B.h. Le fichier B est done inclus dans le fichier A. Mais, et c'est 
la que ga commence a coincer, supposez que le fichier B.h contienne a son tour un 
include du fichier A.h! C a arrive quelques fois en programmation ! Le premier fichier 
a besoin du second pour fonctionner, et le second a besoin du premier. 

Si on y reflechit un peu, on imagine vite ce qu'il va se passer : 

1. l'ordinateur lit A.h et voit qu'il faut inclure B.h; 

2. il lit B.h pour l'inclure, et la il voit qu'il faut inclure A.h; 

3. il inclut done A.h dans B.h, mais dans A.h on lui indique qu'il doit inclure B.h! 

4. rebelote, il va voir B.h et voit a nouveau qu'il faut inclure A.h; 

5. etc. 

Vous vous doutez bien que tout cela est sans fin ! En fait, a force de faire trop d'inclu- 
sions, le preprocesseur s'arretera en disant « J'en ai marre des inclusions ! » ce qui fera 
planter votre compilation. 

Comment diable faire pour eviter cet affreux cauchemar? Voici l'astuce. Desormais, je 
vous demande de faire comme <ja dans TOUS vos fichiers .h sans exception : 

#ifndef DEF_NOMDUFICHIER // si la constante n'a pas ete definie le fichier n'a 
«-> jamais ete inclus 

#define DEF_NOMDUFICHIER // On definit la constante pour que la prochaine fois 
^-> le fichier ne soit plus inclus 

/* Contenu de votre fichier .h (autres include, prototypes, define...) */ 

#endif 

> ( Code web : 698118) 

Vous mettrez en fait tout le contenu de votre fichier .h (a savoir vos autres include, 
vos prototypes, vos define. . .) entre le #ifndef et le #endif . 

Comprenez-vous bien comment ce code fonctionne ? La premiere fois qu'on m'a presente 
cette technique, j'etais assez desoriente : je vais essayer de vous l'expliquer. 

Imaginez que le fichier .h est inclus pour la premiere fois. Le preprocesseur lit la 
condition « Si la constante DEF_NOMDUFICHIER n'a pas ete definie ». Comme c'est la 
premiere fois que le fichier est lu, la constante n'est pas definie, done le preprocesseur 
entre a l'interieur du if. 
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La premiere instruction qu'il rencontre est justement : 

| #def ine DEF_NOMDUFICHIER 

Maintenant, la constante est definie. La prochaine fois que le fichier sera inclus, la 
condition ne sera plus vraie et done le fichier ne risque plus d'etre inclus a nouveau. 

Bien entendu, vous appelez votre constante comme vous voulez. Moi, je l'appelle 
DEF_NOMDUFICHIER par habitude. 

Ce qui compte en revanche, et j'espere que vous l'aviez bien compris, e'est de changer 
de nom de constante a chaque fichier .h different. II ne faut pas que <ja soit la meme 
constante pour tous les fichiers .h, sinon seul le premier fichier .h serait lu et pas les 
autres ! Vous remplacerez done NOMDUFICHIER par le nom de votre fichier .h. 

Je vous invite a aller consulter les .h des bibliotheques standard sur votre 
disque dur. Vous verrez qu'ils sont TOUS construits sur le meme principe (un 
#ifndef au debut et un #endif a la fin). Ms s'assurent ainsi qu'il ne pourra 
pas y avoir d'inclusions infinies. 
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En resume 

- Le preprocesseur est un programme qui analyse votre code source et y effectue des 
modifications avant la compilation. 

- L'instruction de preprocesseur #include insere le contenu d'un autre fichier. 

- L'instruction #def ine definit une constante de preprocesseur. Elle permet de rem- 
placer un mot-cle par une valeur dans le code source. 

- Les macros sont des morceaux de code tout prets definis a l'aide d'un #def ine. lis 
peuvent accepter des parametres. 

- II est possible d'ecrire des conditions en langage preprocesseur pour choisir ce qui 
sera compile. On utilise notamment les mots-cles #if , #elif et #endif . 

- Pour eviter qu'un fichier .h ne soit inclus un nombre infini de fois, on le protege a 
l'aide d'une combinaison de constantes de preprocesseur et de conditions. Tous vos 
futurs fichiers .h devront etre proteges de cette maniere. 
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Creez vos propres types de variables 



L 



Difficulty : WB 

e langage C nous permet de faire quelque chose de tres puissant : creer nos propres 
types de variables. Des « types de variables personnalises », nous allons en voir deux 
sortes : les structures et les enumerations. 



Creer de nouveaux types de variables devient indispensable quand on cherche a faire des 
programmes plus complexes. 

Ce n'est (heureusement) pas bien complique a comprendre et a manipuler. Restez attentifs 
tout de meme parce que nous reutiliserons les structures tout le temps a partir du prochain 
chapitre. II faut savoir que les bibliotheques definissent generalement leurs propres types. 
Vous ne tarderez done pas a manipuler un type de variable Fichier ou encore, un peu plus 
tard, d'autres de types Fenetre, Audio, Clavier, etc. 
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Definir une structure 



Une structure est un assemblage de variables qui peuvent avoir differents types. Contrai- 
rement aux tableaux qui vous obligent a utiliser le meme type dans tout le tableau, 
vous pouvez creer une structure comportant des variables de types long, char, int et 
double a la fois. 

Les structures sont generalement definies dans les fichiers . h, au meme titre done que 
les prototypes et les define. Voici un exemple de structure : 



struct NomDeVotreStructure 
{ 

int variable!.; 

int variable2; 

int autre Variable; 

double nombreDecimal; 

}; 



Une definition de structure commence par le mot-cle struct, suivi du nom de votre 
structure (par exemple Fichier, ou encore Ecran). 

J'ai personnellement I'habitude de nommer mes structures en suivant les 
memes regies que pour les noms de variables, excepte que je mets la pre- 
miere lettre en majuscule pour pouvoir faire la difference. Ainsi, quand je vois 
le mot ageDuCapitaine dans mon code, je sais que e'est une variable car 
cela commence par une lettre minuscule. Quand je vois MorceauAudio je sais 
qu'il s'agit d'une structure (un type personnalise) car cela commence par une 
majuscule. 




a 



Apres le nom de votre structure, vous ouvrez les accolades et les fermez plus loin, 
comme pour une fonction. 



© 



Attention, ici e'est particulier : vous DEVEZ mettre un point-virgule apres 
I'accolade fermante. C'est obligatoire. Si vous ne le faites pas, la compilation 
plantera. 



Et maintenant, que mettre entre les accolades ? C'est simple, vous y placez les variables 
dont est composee votre structure. Une structure est generalement composee d'au moins 
deux « sous-variables », sinon elle n'a pas trop d'interet. 

Comme vous le voyez, la creation d'un type de variable personnalise n'est pas bien 
complexe. Toutes les structures que vous verrez sont en fait des « assemblages » de 
variables de type de base, comme long, int, double, etc. II n'y a pas de miracle, un 
type Fichier n'est done compose que de nombres de base ! 
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Exemple de structure 

Imaginons par exemple que vous vouliez creer une variable qui stocke les coordonnees 
d'un point a l'ecran. Vous aurez tres certainement besoin d'une structure comme cela 
lorsque vous ferez des jeux 2D dans la partie suivante, c'est done l'occasion de s'avancer 
un peu. 

Pour ceux chez qui le mot « geometrie » provoque des apparitions de boutons inexpli- 
cables sur tout le visage, la fig. 15.1 va faire office de petit rappel fondamental sur la 
2D. 



Ordonnees (y) 



i 



Abscisses (x) 

Figure 15.1 - Abscisses et ordonnees 

Lorsqu'on travaille en 2D (2 dimensions), on a deux axes : l'axe des abscisses (de 
gauche a droite) et l'axe des ordonnees (de bas en haut). On a l'habitude d'exprimer 
les abscisses par une variable appelee x, et les ordonnees par y. 

Etes-vous capables d'ecrire une structure Coordonnees qui permette de stocker a la 
fois la valeur de l'abscisse (x) et celle de l'ordonnee (y) d'un point ? Allons, allons, ce 
n'est pas bien difficile : 

struct Coordonnees 
{ 

int x; // Abscisses 

int y; // Ordonnees 

}; 

Notre structure s'appelle Coordonnees et est composee de deux variables, x et y, e'est- 
a-dire de l'abscisse et de l'ordonnee. 

Si on le voulait, on pourrait facilement faire une structure Coordonnees pour de la 3D : 
il suffirait d'ajouter une troisieme variable (par exemple z) qui indiquerait la hauteur. 
Avec <ja, nous aurions une structure faite pour gerer des points en 3D dans l'espace ! 

Tableaux dans une structure 

Les structures peuvent contenir des tableaux. Ca tombe bien, on va pouvoir ainsi 
placer des tableaux de char (chaines de caracteres) sans probleme! Allez, imaginons 
une structure Personne qui stockerait diverses informations sur une personne : 
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struct Personne 
{ 

char nom[100] ; 

char prenom[100] ; 

char adresse [1000] ; 

int age ; 

int garcon; // Booleen : 1 = gargon, = fille 

}; 

Cette structure est composee de cinq sous- variables. Les trois premieres sont des chaines 
qui stockeront le nom, le prenom et l'adresse de la personne. Les deux dernieres stockent 
Page et le sexe de la personne. Le sexe est un booleen, 1 = vrai = gargon, = faux = 
fille. 

Cette structure pourrait servir a creer un programme de carnet d'adresses. Bien en- 
tendu, vous pouvez rajouter des variables dans la structure pour la completer si vous 
le voulez. II n'y a pas de limite au nombre de variables dans une structure. 



Utilisation d'une structure 

Maintenant que notre structure est definie dans le .h, on va pouvoir l'utiliser dans une 
fonction de notre fichier . c. Voici comment creer une variable de type Coordonnees (la 
structure qu'on a definie plus haut) : 

#include "main.h" // Inclusion du .h qui contient les prototypes et structures 

int main(int argc, char *argv[]) 
{ 

struct Coordonnees point; // Creation d'une variable "point" de type 
<— > Coordonnees 

return 0; 
} 

Nous avons ainsi cree une variable point de type Coordonnees. Cette variable est au- 
tomatiquement composee de deux sous- variables : x et y (son abscisse et son ordonnee). 

)^ Faut-il obligatoirement ecrire le mot-cle struct lors de la definition de la 
variable? 



Oui : cela permet a l'ordinateur de differencier un type de base (comme int) d'un type 
personnalise, comme Coordonnees. Toutefois, les programmeurs trouvent souvent un 
peu lourd de mettre le mot struct a chaque definition de variable personnalisee. Pour 
regler ce probleme, ils ont invente une instruction speciale : le typedef . 
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Le typedef 

Retournons dans le fichier .h qui contient la definition de notre structure de type 
Coordonnees. Nous allons ajouter une instruction appelee typedef qui sert a creer un 
alias de structure, c'est-a-dire a dire qu'ecrire telle chose equivaut a ecrire telle autre 
chose. 

Nous allons ajouter une ligne commengant par typedef juste avant la definition de la 
structure : 



typedef struct Coordonnees Coordonnees; 

struct Coordonnees 

{ 

int x; 

int y ; 

}; 

Cette ligne doit etre decoupee en trois morceaux (non, je n'ai pas begaye le mot 
Coordonnees !) : 

- typedef : indique que nous allons creer un alias de structure ; 

- struct Coordonnees : c'est le nom de la structure dont vous allez creer un alias 
(c'est-a-dire un « equivalent ») ; 

- Coordonnees : c'est le nom de l'equivalent. 

En clair, cette ligne dit « Ecrire le mot Coordonnees est desormais equivalent a ecrire 
struct Coordonnees ». En faisant cela, vous n'aurez plus besoin de mettre le mot 
struct a chaque definition de variable de type Coordonnees. On peut done retourner 
dans notre main et ecrire tout simplement : 

int main (int argc, char *argv[]) 
{ 

Coordonnees point; // L'ordinateur comprend qu'il s'agit de "struct 
<— ¥ Coordonnees" grace au typedef 

return ; 
} 

Je vous recommande de faire un typedef comme je l'ai fait ici pour Coordonnees. 
La plupart des programmeurs font comme cela. Ca leur evite d'avoir a ecrire le mot 
struct partout 1 . 



Modifier les composantes de la structure 

Maintenant que notre variable point est creee, nous voulons modifier ses coordonnees. 
Comment acceder au x et au y de point ? Comme ceci : 



1. Un bon programmeur est un programmeur faineant ! II en ecrit le moins possible. 

205 



CHAPITRE 15. CREEZ VOS PROPRES TYPES DE VARIABLES 



int main(int argc, char *argv[]) 
{ 

Coordonnees point ; 



point. x = 10; 
point. y = 20; 

return 0; 



On a ainsi modifie la valeur de point, en lui donnant une abscisse de 10 et une ordonnee 
de 20. Notre point se situe desormais a la position (10 ; 20) 2 . 

Pour acceder done a chaque composante de la structure, vous devez ecrire : 
I variable .nomDeLaComposante 

Le point fait la separation entre la variable et la composante. 

Si on prend la structure Personne que nous avons vue tout a l'heure et qu'on demande 
le nom et le prenom, on devra faire comme <ja : 

int main(int argc, char *argv[]) 
{ 

Personne utilisateur; 

printf ("Quel est votre nom ? "); 
scanf ("'/,s" , utilisateur .nom) ; 
printf ("Votre prenom ? ") ; 
scanf ("'/,s" , utilisateur .prenom) ; 

printf ("Vous vous appelez '/,s '/,s", utilisateur .prenom, utilisateur .nom) ; 

return 0; 



Quel est votre nom ? Dupont 

Votre prenom ? Jean 

Vous vous appelez Jean Dupont 



On envoie la variable utilisateur .nom a scanf qui ecrira directement dans notre 
variable utilisateur. On fait de meme pour prenom, et on pourrait aussi le faire pour 
l'adresse, Page et le sexe, mais je n'ai guere envie de me repeter 3 . 

Vous auriez pu faire la meme chose sans connaitre les structures, en creant juste une 
variable nom et une autre prenom. Mais l'interet ici est que vous pouvez creer une autre 
variable de type Personne qui aura aussi son propre nom, son propre prenom, etc. On 
peut done faire : 



2. C'est la notation mathematique d'une coordonnee. 

3. Je dois etre programmeur, c'est pour ga. ;-) 
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I Per sonne joueurl, joueur2; 

. . . et stocker ainsi les informations sur chaque joueur. Chaque joueur a son propre 
nom, son propre prenom, etc. 

On peut meme faire encore mieux : on peut creer un tableau de Personne ! C'est facile 
a faire : 

I Personne joueurs [2] ; 

Et ensuite, vous accedez par exemple au nom du joueur n°0 en tapant : 

I j oueurs [0] . nom 

L'avantage d'utiliser un tableau ici, c'est que vous pouvez faire une boucle pour deman- 
der les infos du joueur 1 et du joueur 2, sans avoir a repeter deux fois le meme code. 

II sufHt de parcourir le tableau joueur et de demander a chaque fois nom, prenom, 
adresse. . . 

Exercice : creez ce tableau de type Personne et demandez les infos de chacun grace 
a une boucle (qui se repete tant qu'il y a des joueurs). Faites un petit tableau de 2 
joueurs pour commencer, mais si <ja vous amuse, vous pourrez agrandir la taille du 
tableau plus tard. Affichez a la fin du programme les infos que vous avez recueillies sur 
chacun des joueurs. 

Initialiser une structure 

Pour les structures comme pour les variables, tableaux et pointeurs, il est vivement 
conseille de les initialiser des leur creation pour eviter qu'elles ne contiennent « n'im- 
porte quoi ». En effet, je vous le rappelle, une variable qui est creee prend la valeur de 
ce qui se trouve en memoire la ou elle a ete placee. Parfois cette valeur est 0, parfois 
c'est un residu d'un autre programme qui est passe par la avant vous et la variable a 
alors une valeur qui n'a aucun sens, comme -84570. 

Pour rappel, voici comment on initialise : 

- une variable : on met sa valeur a (cas le plus simple) ; 

- un pointeur : on met sa valeur a NULL. NULL est en fait un #def ine situe dans 
stdlib.h qui vaut generalement 0, mais on continue a utiliser NULL, par convention, 
sur les pointeurs pour bien voir qu'il s'agit de pointeurs et non de variables ordinaires ; 

- un tableau : on met chacune de ses valeurs a 0. 

Pour les structures, l'initialisation va un peu ressembler a celle d'un tableau. En effet, 
on peut faire a la declaration de la variable : 

I Coordonnees point = {0, 0}; 

Cela definira, dans l'ordre, point. x = et point. y = 0. 
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Revenons a la structure Personne (qui contient des chaines). Vous avez aussi le droit 
d'initialiser une chaine en ecrivant juste "" (rien entre les guillemets). Je ne vous ai 
pas parle de cette possibility dans le chapitre sur les chaines, mais il n'est pas trop tard 
pour l'apprendre. On peut done initialiser dans l'ordre nom, prenom, adresse, age et 
gar con comme ceci : 

|Personne utilisateur = {"", "", "", 0, 0}; 

Toutefois, j 'utilise assez peu cette technique, personnellement. Je prefere envoyer par 
exemple ma variable point a une fonction initialiserCoordonnees qui se charge 
de faire les initialisations pour moi sur ma variable. Pour faire cela il faut envoyer un 
pointeur de ma variable. En effet si j'envoie juste ma variable, une copie en sera realisee 
dans la fonction (comme pour une variable de base) et la fonction modifiera les valeurs 
de la copie et non celle de ma vraie variable. Revoyez le fil rouge du chapitre sur les 
pointeurs si vous avez oublie comment cela fonctionne. 

II va done falloir apprendre a utiliser des pointeurs sur des structures. Les choses vont 
commencer a se corser un petit peu ! 

Pointeur de structure 

Un pointeur de structure se cree de la meme maniere qu'un pointeur de int, de double 
ou de n'importe quelle autre type de base : 

I Coordonnees* point = NULL; 

On a ainsi un pointeur de Coordonnees appele point. Comme un rappel ne fera de 
mal a personne, je tiens a vous repeter que l'on aurait aussi pu mettre l'etoile devant 
le nom du pointeur, cela revient exactement au meme : 

I Coordonnees *point = NULL; 

Je fais d'ailleurs assez souvent comme cela, car pour definir plusieurs pointeurs sur la 
meme ligne, nous sommes obliges de placer l'etoile devant chaque nom de pointeur : 

I Coordonnees *pointl = NULL, *point2 = NULL; 

Envoi de la structure a une fonction 

Ce qui nous interesse ici, e'est de savoir comment envoyer un pointeur de structure a 
une fonction pour que celle-ci puisse modifier le contenu de la variable. 

On va faire ceci pour cet exemple : on va simplement creer une variable de type 
Coordonnees dans le main et envoyer son adresse a initialiserCoordonnees. Cette 
fonction aura pour rflle de mettre tous les elements de la structure a 0. 
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Notre fonction initialiserCoordonnees va prendre un parametre : un pointeur sur 
une structure de type Coordonnees (un Coordonnees*, done). 

int main(int argc, char *argv[]) 
{ 

Coordonnees monPoint ; 

initialiserCoordonnees (fanonPoint) ; 

return ; 



void initialiserCoordonnees (Coordonnees* point) 
{ 

// Initialisation de chacun des membres de la structure ici 
} 

Ma variable monPoint est done creee dans le main. On envoie son adresse a la fonction 
initialiserCoordonnees qui recupere cette variable sous la forme d'un pointeur ap- 
pele point (on aurait d'ailleurs pu l'appeler n'importe comment dans la fonction, cela 
n'aurait pas eu d'incidence). 

Bien : maintenant que nous sommes dans initialiserCoordonnees, nous allons ini- 
tialiser chacune des valeurs une a une. II ne faut pas oublier de mettre une etoile devant 
le nom du pointeur pour acceder a la variable. Si vous ne le faites pas, vous risquez de 
modifier l'adresse, et ce n'est pas ce que nous voulons faire. 

Oui mais voila, probleme. . . On ne peut pas vraiment faire : 

void initialiserCoordonnees (Coordonnees* point) 
{ 

*point.x = 0; 

*point.y = 0; 
} 

Ce serait trop facile. . . Pourquoi on ne peut pas faire <ja ? Parce que le point de separa- 
tion s'applique sur le mot point et non sur *point en entier. Or, nous ce qu'on veut, 
e'est acceder a *point pour en modifier la valeur. Pour regler le probleme, il faut placer 
des parentheses autour de *point. Comme cela, le point de separation s'appliquera a 
♦point et non juste a point : 

void initialiserCoordonnees (Coordonnees* point) 
{ 

(*point) . x = 0; 

(*point) . y = 0; 
} 

Ce code fonctionne, vous pouvez tester. La variable de type Coordonnees a ete trans- 
mise a la fonction qui a initialise x et y a 0. 
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En langage C, on initialise generalement nos structures avec la methode simple 
qu'on a vue plus haut. En C++ en revanche, les initialisations sont plus 
souvent faites dans des « fonctions ». Le C++ n'est en fait rien d'autre qu'une 
sorte de « super-amelioration » des structures. Bien entendu, beaucoup de 
choses decoulent de cela et il faudrait un livre entier pour en parler 4 . 




a 



Un raccourci pratique et tres utilise 

Vous allez voir qu'on manipulera tres souvent des pointeurs de structures. Pour etre 
franc, je dois meme vous avouer qu'en C, on utilise plus souvent des pointeurs de 
structures que des structures tout court 5 . 

Comme les pointeurs de structures sont tres utilises, on sera souvent amene a ecrire 
ceci : 

I (*point) . x = 0; 

Oui mais voila, encore une fois les programmeurs trouvent <ja trop long. Les parentheses 
autour de *point, quelle plaie ! Alors, comme les programmeurs sont des gens faineants 
(mais ca, je l'ai deja dit, je crois), ils ont invente le raccourci suivant : 

I point ->x = 0; 

Ce raccourci consiste a former une fleche avec un tiret suivi d'un chevron >. 
Ecrire point ->x est done STRICTEMENT equivalent a ecrire Opoint) .x. 



A 



N'oubliez pas qu'on ne peut utiliser la fleche que sur un pointeur! Si vous 
travaillez directement sur la variable, vous devez utiliser le point comme on 
I'a vu au debut. 



Reprenons notre fonction initialiserCoordonnees. Nous pouvons done l'ecrire comme 
ceci : 

void initialiserCoordonnees (Coordonnees* point) 
{ 

point->x = 0; 

point->y = 0; 
} 

Retenez bien ce raccourci de la fleche, nous allons le reutiliser un certain nombre de 
fois. Et surtout, ne confondez pas la fleche avec le « point ». La fleche est reservee aux 
pointeurs, le « point » est reserve aux variables. Utilisez ce petit exemple pour vous en 
souvenir : 



4. Chaque chose en son temps. 

5. Quand je vous disais que les pointeurs vous poursuivraient jusque dans votre tombe, je ne le 
disais presque pas en rigolant ! 
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int main(int argc, char *argv[]) 
{ 

Coordonnees monPoint ; 

Coordonnees *pointeur = fanonPoint ; 

monPoint. x = 10; // On travaille sur une variable, on utilise le "point" 
pointeur->x =10; // On travaille sur un pointeur, on utilise la fleche 

return ; 



On modifie la valeur du x a 10 de deux manieres differentes, ici : la premiere fois en 
travaillant directement sur la variable, la seconde fois en passant par le pointeur. 



Les enumerations 

Les enumerations constituent une fagon un peu differente de creer ses propres types de 
variables. 

Une enumeration ne contient pas de « sous-variables » comme c'etait le cas pour les 
structures. C'est une liste de « valeurs possibles » pour une variable. Une enumeration 
ne prend done qu'une case en memoire et cette case peut prendre une des valeurs que 
vous defmissez (et une seule a la fois). 

Voici un exemple d'enumeration : 

typedef enum Volume Volume; 

enum Volume 

{ 

FAIBLE, MOYEN, FORT 

}; 

Vous noterez qu'on utilise un typedef la aussi, comme on l'a fait jusqu'ici. 

Pour creer une enumeration, on utilise le mot-cle enum. Notre enumeration s'appelle ici 
Volume. C'est un type de variable personnalise qui peut prendre une des trois valeurs 
qu'on a indiquees : soit FAIBLE, soit MOYEN, soit FORT. 

On va pouvoir creer une variable de type Volume, par exemple musique, qui stockera 
le volume actuel de la musique. On peut par exemple initialiser la musique au volume 

MOYEN : 

I Volume musique = MOYEN; 

Voila qui est fait. Plus tard dans le programme, on pourra modifier la valeur du volume 
et la mettre soit a FAIBLE, soit a FORT. 
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Association de nombres aux valeurs 

Vous avez remarque que j'ai ecrit les valeurs possibles de l'enumeration en majuscules. 
Cela devrait vous rappeler les constantes et les define, non? 

En effet, c'est assez similaire mais ce n'est pourtant pas exactement la meme chose. Le 
compilateur associe automatiquement un nombre a chacune des valeurs possibles de 
l'enumeration. 

Dans le cas de notre enumeration Volume, FAIBLE vaut 0, MOYEN vaut 1 et FORT vaut 
2. L'association est automatique et commence a 0. 

Contrairement au #def ine, c'est le compilateur qui associe MOYEN a 1 par exemple, et 
non le preprocesseur. Au bout du compte, ga revient un peu au meme. En fait, quand 
on a initialise la variable musique a MOYEN, on a done mis la case en memoire a la 
valeur 1. 



) En pratique, est-ce utile de savoir que MOYEN vaut 1, FORT vaut 2, etc. ? 




Non. En general ga nous est egal. C'est le compilateur qui associe automatiquement 
un nombre a chaque valeur. Grace a ga, vous n'avez plus qu'a ecrire : 

if (musique == MOYEN) 
{ 

// Jouer la musique au volume moyen 
} 

Peu importe la valeur de MOYEN, vous laissez le compilateur se charger de gerer les 
nombres. 

L'interet de tout ga? C'est que de ce fait votre code est tres lisible. En effet, tout le 
monde peut facilement lire le if precedent (on comprend bien que la condition signifie 
« Si la musique est au volume moyen »). 



Associer une valeur precise 

Pour le moment, c'est le compilateur qui decide d'associer le nombre a la premiere 
valeur, puis 1, 2, 3 dans l'ordre. II est possible de demander d'associer une valeur precise 
a chaque element de l'enumeration. 

Quel interet est-ce que ga peut bien avoir ? Eh bien supposons que sur votre ordinateur, 
le volume soit gere entre et 100 (0 = pas de son, 100 = 100 % du son). II est alors 
pratique d'associer une valeur precise a chaque element : 

typedef enum Volume Volume; 

enum Volume 

{ 
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FAIBLE = 10, MOYEN = 50, FORT = 100 

}; 

Ici, le volume FAIBLE correspondra a 10 % de volume, le volume MOYEN a 50 %, etc. On 
pourrait facilement ajouter de nouvelles valeurs possibles comme MUET. On associerait 
dans ce cas MUET a la valeur. . . ! Vous avez compris. 



En resume 

- Une structure est un type de variable personnalise que vous pouvez creer et utiliser 
dans vos programmes. C'est a vous de la definir, contrairement aux types de base 
tels que int et double que l'on retrouve dans tous les programmes. 

- Une structure est composee de « sous-variables » qui sont en general des variables 
de type de base comme int et double, mais aussi des tableaux. 

- On accede a un des composants de la structure en separant le nom de la variable et 
la composante d'un point : joueur .prenom. 

- Si on manipule un pointeur de structure et qu'on veut acceder a une des composantes, 
on utilise une fleche a la place du point : pointeurJoueur->prenom. 

- Une enumeration est un type de variable personnalise qui peut seulement prendre 
une des valeurs que vous predefinissez : FAIBLE, MOYEN ou FORT par exemple. 
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Lire et ecrire dans des fichiers 



Difficulty : WB 

Le defaut avec les variables, c'est qu'elles n'existent que dans la memoire vive. Une 
fois votre programme arrete, toutes vos variables sont supprimees de la memoire et il 
n'est pas possible de retrouver ensuite leur valeur. Comment peut-on, dans ce cas-la, 
enregistrer les meilleurs scores obtenus a son jeu ? Comment peut-on faire un editeur de 
texte si tout le texte ecrit disparatt lorsqu'on arrete le programme? 

Heureusement, on peut lire et ecrire dans des fichiers en langage C. Ces fichiers seront 
ecrits sur le disque dur de votre ordinateur : I'avantage est done qu'ils restent la, meme si 
vous arretez le programme ou I'ordinateur. 

Pour lire et ecrire dans des fichiers, nous allons avoir besoin de reutiliser tout ce que nous 
avons appris jusqu'ici : pointeurs, structures, chames de caracteres, etc. 
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Ouvrir et fermer un fichier 

Pour lire et ecrire dans des fichiers, nous allons nous servir de fonctions situees dans 
la bibliotheque stdio que nous avons deja utilisee. Oui, cette bibliotheque-la contient 
aussi les fonctions printf et scanf que nous connaissons bien ! Mais elle ne contient pas 
que ga : il y a aussi d'autres fonctions, notamment des fonctions faites pour travailler 
sur des fichiers. 

Toutes les bibliotheques que je vous ai fait utiliser jusqu'ici (stdlib.h, 
stdio. h, math.h, string. h...) sont ce qu'on appelle des bibliotheques 
standard. Ce sont des bibliotheques automatiquement livrees avec votre IDE 
qui ont la particularity de fonctionner sur tous les OS. Vous pouvez done 
les utiliser partout, que vous soyez sous Windows, Linux, Mac ou autre. Les 
bibliotheques standard ne sont pas tres nombreuses et ne permettent de faire 
que des choses tres basiques, comme ce que nous avons fait jusqu'ici. Pour 
obtenir des fonctions plus avancees, comme ouvrir des fenetres, il faudra te- 
lecharger et installer de nouvelles bibliotheques. Nous verrons cela bientot I 

Assurez-vous done, pour commencer, que vous incluez bien au moins les bibliotheques 
stdio. h et stdlib.h en haut de votre fichier .c : 

#include <stdlib.h> 
#include <stdio.h> 

Ces bibliotheques sont tellement fondamentales, tenement basiques, que je vous recom- 
mande d'ailleurs de les inclure dans tous vos futurs programmes, quels qu'ils soient. 

Bien. Maintenant que les bonnes bibliotheques sont incluses, nous allons pouvoir atta- 
quer les choses serieuses. Void ce qu'il faut faire a chaque fois dans l'ordre quand on 
veut ouvrir un fichier, que ce soit pour le lire ou pour y ecrire. 

1. On appelle la fonction d'ouverture de fichier f open qui nous renvoie un poin- 
teur sur le fichier. 

2. On verifie si l'ouverture a reussi (e'est-a-dire si le fichier existait) en testant 
la valeur du pointeur qu'on a regu. Si le pointeur vaut NULL, e'est que l'ouverture 
du fichier n'a pas fonctionne, dans ce cas on ne peut pas continuer (il faut afHcher 
un message d'erreur). 

3. Si l'ouverture a fonctionne (si le pointeur est different de NULL done), alors on 
peut s'amuser a lire et ecrire dans le fichier a travers des fonctions que nous 
verrons un peu plus loin. 

4. Une fois qu'on a termine de travailler sur le fichier, il faut penser a le 
« fermer » avec la fonction f close. 

Nous allons dans un premier temps apprendre a nous servir de f open et f close. Une 
fois que vous saurez faire cela, nous apprendrons a lire le contenu du fichier et a y ecrire 
du texte. 
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f open : ouverture du fichier 

Dans le chapitre sur les chaines, nous nous sommes servis des prototypes des fonctions 
comme d'un « mode d'emploi ». C'est comme ga que les programmeurs font en general : 
ils lisent le prototype et comprennent comment ils doivent utiliser la fonction 1 . 

Voyons justement le prototype de la fonction f open : 

I FILE* fopen(const char* nomDuFichier, const char* modeOuverture) ; 

Cette fonction attend deux parametres : 

- le nom du fichier a ouvrir ; 

- le mode d'ouverture du fichier, c'est-a-dire une indication qui mentionne ce que vous 
voulez faire : seulement ecrire dans le fichier, seulement le lire, ou les deux a la fois. 

Cette fonction renvoie. . . un pointeur sur FILE ! C'est un pointeur sur une structure 
de type FILE. Cette structure est definie dans stdio.h. Vous pouvez ouvrir ce fichier 
pour voir de quoi est constitue le type FILE, mais ga n'a aucun interet en ce qui nous 
concerne. 




f 



Pourquoi le nom de la structure est-il tout en majuscules (FILE) ? Je croyais 
que les noms tout en majuscules etaient reserves aux constantes et aux 
define ? 

Cette « regie », c'est moi qui me la suis fixee (et nombre d'autres programmeurs suivent 
la meme, d'ailleurs). C a n ' a jamais ete une obligation. Force est de croire que ceux qui 
ont programme stdio ne suivaient pas exactement les memes regies ! Cela ne doit 
pas vous perturber pour autant. Vous verrez d'ailleurs que les bibliotheques que nous 
etudierons ensuite respectent les memes regies que moi, a savoir ici mettre juste la 
premiere lettre d'une structure en majuscule. 

Revenons a notre fonction f open. Elle renvoie un FILE*. II est extremement important 
de recuperer ce pointeur pour pouvoir ensuite lire et ecrire dans le fichier. Nous allons 
done creer un pointeur de FILE au debut de notre fonction (par exemple la fonction 



int main(int argc, char *argv[]) 
{ 

FILE* fichier = NULL; 

return ; 
} 

Le pointeur est initialise a NULL des le debut. Je vous rappelle que c'est une regie 
fondamentale que d'initialiser ses pointeurs a NULL des le debut si on n'a pas d'autre 



1. Je reconnais neanmoins que Ton a toujours besoin de quelques petites explications a cote quand 
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valeur a leur dormer. Si vous ne le faites pas, vous augmentez considerablement le risque 
d'erreur par la suite. 

Vous noterez qu'il n'est pas necessaire d'ecrire struct FILE* fichier = 
NULL. Les createurs de stdio ont done fait un typedef comme je vous ai 
appris a le faire il n'y a pas longtemps. Notez que la forme de la structure 
peut changer d'un OS a I'autre (elle ne contient pas forcement les memes 
sous-variables partout). Pour cette raison, on ne modifiera jamais le contenu 
d'un FILE directement (on ne fera pas fichier .element par exemple). On 
passera par des fonctions qui manipulent le FILE a notre place. 




a 



Maintenant, nous allons appeler la fonction f open et recuperer la valeur qu'elle renvoie 
dans le pointeur fichier. Mais avant ca, il faut que je vous explique comment se servir 
du second parametre, le parametre modeOuverture. En effet, il y a un code a envoyer 
qui indiquera a l'ordinateur si vous ouvrez le fichier en mode de lecture seule, d'ecriture 
seule, ou des deux a la fois. Voici les modes d'ouverture possibles. 

- "r" : lecture seule. Vous pourrez lire le contenu du fichier, mais pas y ecrire. Le 
fichier doit avoir ete cree au prealable. 

- "w" : ecriture seule. Vous pourrez ecrire dans le fichier, mais pas lire son contenu. 
Si le fichier n'existe pas, il sera cree. 

- "a" : mode d'ajout. Vous ecrirez dans le fichier, en partant de la fin du fichier. 
Vous ajouterez done du texte a la fin du fichier. Si le fichier n'existe pas, il sera cree. 

- "r+" : lecture et ecriture. Vous pourrez lire et ecrire dans le fichier. Le fichier doit 
avoir ete cree au prealable. 

- "w+" : lecture et ecriture, avec suppression du contenu au prealable. Le 
fichier est done d'abord vide de son contenu, vous pouvez y ecrire, et le lire ensuite. 
Si le fichier n'existe pas, il sera cree. 

- "a+" : ajout en lecture / ecriture a la fin. Vous ecrivez et lisez du texte a partir 
de la fin du fichier. Si le fichier n'existe pas, il sera cree. 

Pour information, je ne vous ai presente qu'une partie des modes d'ouverture. II y 
en a le double, en realite! Pour chaque mode qu'on a vu la, si vous ajoutez un "b" 
apres le premier caractere ("rb", "wb", "ab", "rb+", "wb+", "ab+"), alors le fichier 
est ouvert en mode binaire. C'est un mode un peu particulier que nous ne verrons 
pas ici. En fait, le mode texte est fait pour stocker. . . du texte comme le nom l'indique 
(uniquement des caracteres afHchables), tandis que le mode binaire permet de stocker. . . 
des informations octet par octet (des nombres, principalement). C'est sensiblement 
different. Le fonctionnement est de toute facon quasiment le meme que celui que nous 
allons voir ici. 

Personnellement, j 'utilise souvent "r" (lecture), "w" (ecriture) et "r+" (lecture et ecri- 
ture). Le mode "w+" est un peu dangereux parce qu'il vide de suite le contenu du 
fichier, sans demande de confirmation. II ne doit etre utilise que si vous voulez d'abord 
reinitialiser le fichier. Le mode d'ajout ("a") peut etre utile dans certains cas, si vous 
voulez seulement ajouter des informations a la fin du fichier. 
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Si vous avez juste I'intention de lire un fichier, il est conseille de mettre "r". 
Certes, le mode "r+" aurait fonctionne lui aussi, mais en mettant "r" vous 
vous assurez que le fichier ne pourra pas etre modifie, ce qui est en quelque 
sorte une securite. 

Si vous ecrivez une fonction chargerNiveau (pour charger le niveau d'un jeu, par 
exemple), le mode "r" sufRt. Si vous ecrivez une fonction enregistrerNiveau, le mode 
"w" sera alors adapte. 

Le code suivant ouvre le fichier test.txt en mode "r+" (lecture / ecriture) : 

int main(int argc, char *argv[]) 
{ 

FILE* fichier = NULL; 

fichier = f open("test . txt" , "r+") ; 

return ; 
} 

Le pointeur fichier devient alors un pointeur sur test.txt. 




^ 



Ou doit etre situe test . txt ? 



II doit etre situe dans le meme dossier que votre executable (.exe). Pour les besoins 
de ce chapitre, creez un fichier test . txt comme moi dans le meme dossier que le . exe 
(fig. 16.1). 

Comme vous le voyez, je travaille actuellement avec l'IDE Code: :Blocks, ce qui explique 
la presence d'un fichier de projet . cbp (au lieu de . sin, si vous avez Visual C++ par 
exemple). Bref, ce qui compte c'est de bien voir que mon programme (tests.exe) est 
situe dans le meme dossier que le fichier dans lequel on va lire et ecrire (test .txt). 




H Le fichier doit-il etre de type .txt? 



Non. C'est vous qui choisissez l'extension lorsque vous ouvrez le fichier. Vous pouvez 
tres bien inventer votre propre format de fichier .niveau pour enregistrer les niveaux 
de vos jeux par exemple. 

Le fichier doit-il etre obligatoirement dans le meme repertoire que I'execu- 
J table? 



Non plus. II peut etre dans un sous-dossier : 
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Figure 16.1 - Le fichier doit etre place dans le meme dossier que l'executable 



I f ichier = f open("dossier/test .txt" , "r+") ; 

Ici, le fichier test. txt est dans un sous-dossier appele dossier. Cette methode, que 
l'on appelle chemin relatif est plus pratique. Comme ga, cela fonctionnera peu importe 
l'endroit ou est installe votre programme. 

II est aussi possible d'ouvrir un autre fichier n'importe ou ailleurs sur le disque dur. 
Dans ce cas, il faut ecrire le chemin complet (ce qu'on appelle le chemin absolu) : 

I fichier = f open("C :\\Program Files\\Notepad++\\readme. txt" , "r+"); 

Ce code ouvre le fichier readme.txt situe dans C:\Program Files\Notepad++. 



A 



J'ai du mettre deux antislashs \ a chaque fois comme vous I'avez remarque. En 
effet, si j'en avais ecrit un seul, votre ordinateur aurait cru que vous essayiez 
d'inserer un symbole special comme \n ou \t. Pour ecrire un antislash dans 
une chame, il faut done I'ecrire deux fois I Votre ordinateur comprend alors 
que e'est bien le symbole \ que vous vouliez utiliser. 



Le defaut des chemins absolus, e'est qu'ils ne fonctionnent que sur un OS precis. Ce 
n'est pas une solution portable, done. Si vous aviez ete sous Linux, vous auriez du ecrire 
un chemin a-la-linux, tel que : 

I fichier = f open("/home/mateo/dossier/readme . txt" , "r+"); 
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Je vous recommande done d'utiliser des chemins relatifs plutot que des chemins absolus. 
N'utilisez les chemins absolus que si votre programme est fait pour un OS precis et 
doit modifier un fichier precis quelque part sur votre disque dur. 

Tester l'ouverture du fichier 

Le pointeur fichier devrait contenir l'adresse de la structure de type FILE qui sert 
de descripteur de fichier. Celui-ci a ete charge en memoire pour vous par la fonction 
fopen(). A partir de la, deux possibilites : 

- soit l'ouverture a reussi, et vous pouvez continuer (e'est-a-dire commencer a lire et 
ecrire dans le fichier) ; 

- soit l'ouverture a echoue parce que le fichier n'existait pas ou etait utilise par un 
autre programme. Dans ce cas, vous devez arreter de travailler sur le fichier. 

Juste apres l'ouverture du fichier, il faut imperativement verifier si l'ouverture a reussi 
ou non. Pour faire <ja, e'est tres simple : si le pointeur vaut NULL, l'ouverture a echoue. 
S'il vaut autre chose que NULL, l'ouverture a reussi. On va done suivre systematiquement 
le schema suivant : 

int main(int argc, char *argv[]) 
{ 

FILE* fichier = NULL; 

fichier = f open("test . txt" , "r+") ; 

if (fichier != NULL) 
{ 

// On peut lire et ecrire dans le fichier 
} 

else 
{ 

// On affiche un message d'erreur si on veut 

printf ("Impossible d'ouvrir le fichier test. txt"); 
} 

return ; 



Faites toujours cela lorsque vous ouvrez un fichier. Si vous ne le faites pas et que le 
fichier n'existe pas, vous risquez un plantage du programme par la suite. 

f close : fermer le fichier 

Si l'ouverture du fichier a reussi, vous pouvez le lire et y ecrire (nous allons voir sous 
peu comment faire). Une fois que vous aurez fini de travailler avec le fichier, il faudra 
le « fermer ». On utilise pour cela la fonction f close qui a pour role de liberer la 
memoire, e'est-a-dire supprimer votre fichier charge dans la memoire vive. 
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Son prototype est : 

lint f close (FILE* pointeurSurFichier) ; 

Cette fonction prend un parametre : votre pointeur sur le fichier. Elle renvoie un int 
qui indique si elle a reussi a fermer le fichier. Cet int vaut : 

- : si la fermeture a marche ; 

- EOF : si la fermeture a echoue. EOF est un define situe dans stdio.h qui correspond 
a un nombre special, utilise pour dire soit qu'il y a eu une erreur, soit que nous 
sommes arrives a la fin du fichier. Dans le cas present cela signifie qu'il y a eu une 
erreur. 

A priori, la fermeture se passe toujours bien : je n'ai done pas l'habitude de tester si le 
f close a marche. Vous pouvez neanmoins le faire si vous le voulez. 

Pour fermer le fichier, on va done ecrire : 

I f close (fichier) ; 

Au final, le schema que nous allons suivre pour ouvrir et fermer un fichier sera le 
suivant : 

int main(int argc, char *argv[]) 
{ 

FILE* fichier = NULL; 

fichier = fopenCtest.txt", "r+"); 

if (fichier != NULL) 
{ 

// On lit et on ecrit dans le fichier 

// ... 

f close (fichier) ; // On ferme le fichier qui a ete ouvert 
} 

return 0; 



Je n'ai pas mis le else ici pour afHcher un message d'erreur si l'ouverture a echoue, 
mais vous pouvez le faire si vous le desirez. 

II faut toujours penser a fermer son fichier une fois que l'on a fini de travailler avec. 
Cela permet de liberer de la memoire. Si vous oubliez de liberer la memoire, votre 
programme risque a la fin de prendre enormement de memoire qu'il n'utilise plus. Sur 
un petit exemple comme ga ce n'est pas flagrant, mais sur un gros programme, bonjour 
les degats ! 
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Oublier de liberer la memoire, ga arrive. Qa vous arrivera d'ailleurs tres certainement. 
Dans ce cas, vous serez temoins de ce que l'on appelle des fuites memoire. Votre pro- 
gramme se mettra alors a utiliser plus de memoire que necessaire sans que vous arriviez 
a comprendre pourquoi. Bien souvent, il s'agit simplement d'un ou deux « details » 
comme des petits f close oublies. 

Differentes methodes de lecture / ecriture 

Maintenant que nous avons ecrit le code qui ouvre et ferme le fichier, nous n'avons plus 
qu'a inserer le code qui le lit et y ecrit. 

Nous allons commencer par voir comment ecrire dans un fichier (ce qui est un peu plus 
simple), puis nous verrons ensuite comment lire dans un fichier. 

Ecrire dans le fichier 

II existe plusieurs fonctions capables d'ecrire dans un fichier. Ce sera a vous de choisir 
celle qui est la plus adaptee a votre cas. Voici les trois fonctions que nous allons etudier : 

- fputc : ecrit un caractere dans le fichier (UN SEUL caractere a la fois) ; 

- fputs : ecrit une chaine dans le fichier; 

- fprintf : ecrit une chaine « formatee » dans le fichier, fonctionnement quasi- 
identique a printf . 

fputc 

Cette fonction ecrit un caractere a la fois dans le fichier. Son prototype est : 

lint fputc(int caractere, FILE* pointeurSurFichier) ; 

Elle prend deux parametres. 

- Le caractere a ecrire (de type int, ce qui comme je vous l'ai dit revient plus ou moins 
a utiliser un char, sauf que le nombre de caracteres utilisables est ici plus grand). 
Vous pouvez done ecrire directement 'A' par exemple. 

- Le pointeur sur le fichier dans lequel ecrire. Dans notre exemple, notre pointeur 
s'appelle fichier. L'avantage de demander le pointeur de fichier a chaque fois, e'est 
que vous pouvez ouvrir plusieurs fichiers en meme temps et done lire et ecrire dans 
chacun de ces fichiers. Vous n'etes pas limites a un seul fichier ouvert a la fois. 

La fonction retourne un int, e'est un code d'erreur. Cet int vaut EOF si l'ecriture a 
echoue, sinon il a une autre valeur. Comme le fichier a normalement ete ouvert avec 
succes, je n'ai pas l'habitude de tester si chacun de mes fputc a reussi, mais vous 
pouvez le faire encore une fois si vous le voulez. 

Le code suivant ecrit la lettre 'A' dans test.txt (si le fichier existe, il est remplace; 
s'il n'existe pas, il est cree). II y a tout dans ce code : ouverture, test de l'ouverture, 
ecriture et fermeture. 
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int main(int argc, char *argv[]) 
{ 

FILE* fichier = NULL; 

fichier = fopenCtest.txt", "w") ; 

if (fichier != NULL) 
{ 

fputc('A', fichier); // Ecriture du caractere A 

f close(f ichier) ; 
} 

return 0; 



> ( Code web : 517944) 

Ouvrez votre fichier test . txt. Que voyez-vous ? C'est magique, le fichier contient main- 
tenant la lettre 'A' comme le montre la fig. 16.2. 



test, txt 

Document texte 
1 Ko 



test. txt - Bloc -notes 



Fichier Edition Format Affichai 



Figure 16.2 - Le fichier contient desormais la lettre 'A' 



fputs 

Cette fonction est tres similaire a fputc, a la difference pres qu'elle ecrit tout une 
chaine, ce qui est en general plus pratique que d'ecrire caractere par caractere. Cela 
dit, fputc reste utile lorsque vous devez ecrire caractere par caractere, ce qui arrive 
frequemment. 

Prototype de la fonction : 

I char* fputs (const char* chaine, FILE* pointeurSurFichier) ; 

Les deux parametres sont faciles a comprendre. 

- chaine : la chaine a ecrire. Notez que le type ici est const char* : en ajoutant le mot 
const dans le prototype, la fonction indique que pour elle la chaine sera consideree 
comme une constante. En un mot comme en cent : elle s'interdit de modifier le 
contenu de votre chaine. C'est logique quand on y pense : fputs doit juste lire 
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votre chaine, pas la modifier. C'est done pour vous une information (et une securite) 
comme quoi votre chaine ne subira pas de modification. 
- pointeurSurFichier : comme pour fputc, il s'agit de votre pointeur de type FILE* 
sur le fichier que vous avez ouvert. 

La fonction renvoie EOF s'il y a eu une erreur, sinon c'est que cela a fonctionne. La non 
plus, je ne teste en general pas la valeur de retour. 

Testons l'ecriture d'une chaine dans le fichier : 

int main(int argc, char *argv[]) 
{ 

FILE* fichier = NULL; 

fichier = fopenCtest.txt", "w"); 

if (fichier != NULL) 
{ 

fputs("Salut les ZerOs\nComment allez-vous ?", fichier); 

f close (fichier) ; 
} 

return ; 



> [ Code web : 840687 ) 

La fig. 16.3 presente le fichier une fois modifie par le programme. 



test.txt 

Document texte 
1 Ko 



test.txt - Bloc -notes 



Fichier Edition Format Affichage 



salut les zerQs 
comment allez-vous ? 



Figure 16.3 - Le fichier contient desormais notre chaine 



fprintf 

Voici un autre exemplaire de la fonction printf . Celle-ci peut etre utilisee pour ecrire 
dans un fichier. Elle s'utilise de la meme maniere que printf d'ailleurs, excepte le fait 
que vous devez indiquer un pointeur de FILE en premier parametre. 

Ce code demande Page de l'utilisateur et l'ecrit dans le fichier (resultat fig. 16.4) : 

int main (int argc, char *argv[]) 
{ 
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FILE* fichier = NULL; 
int age = ; 

fichier = fopenCtest.txt", "w") ; 

if (fichier != NULL) 
{ 

// On demande 1'a.ge 

printf("Quel age avez-vous ? ") ; 

scanf ("*/,d" , &age) ; 

// On l'ecrit dans le fichier 

fprintf (fichier , "Le Monsieur qui utilise le programme, il a */,d ans", 
'-t age) ; 

f close(f ichier) ; 
} 

return 0; 



> ( Code web : 119039) 



■ ~^r=4.inna 



Ml'Uil'W-il 



Fichier Edition Format Affichage 



Le Monsieur qui utilise le programme, il a 20 ans 



Figure 16.4 - Ecriture dans un fichier avec fprintf 

Vous pouvez ainsi facilement reutiliser ce que vous savez de printf pour ecrire dans 
un fichier ! C'est pour cette raison d'ailleurs que j 'utilise le plus souvent fprintf pour 
ecrire dans des fichiers. 



Lire dans un fichier 

Nous pouvons utiliser quasiment les memes fonctions que pour l'ecriture, le nom change 
juste un petit peu : 

- fgetc : lit un caractere ; 

- fgets : lit une chaine ; 

- f scanf : lit une chaine formatee. 

Je vais cette fois aller un peu plus vite dans l'explication de ces fonctions : si vous avez 
compris ce que j'ai ecrit plus haut, ga ne devrait pas poser de probleme. 
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f getc 

Tout d'abord le prototype : 

lint f getc (FILE* pointeurDeFichier) ; 

Cette fonction retourne un int : c'est le caractere qui a ete lu. Si la fonction n'a pas 
pu lire de caractere, elle retourne EOF. 

Mais comment savoir quel caractere on lit? Si on veut lire le troisieme carac- 
V tere, ainsi que le dixieme caractere, comment doit-on faire? 

En fait, au fur et a mesure que vous lisez un fichier, vous avez un « curseur » qui 
avance. C'est un curseur virtuel bien entendu, vous ne le voyez pas a l'ecran. Vous 
pouvez imaginer que ce curseur est comme la barre clignotante lorsque vous editez un 
fichier sous Bloc-Notes. II indique ou vous en etes dans la lecture du fichier. 

Nous verrons peu apres comment savoir a quelle position le curseur est situe dans le 
fichier et egalement comment modifier la position du curseur (pour le remettre au debut 
du fichier par exemple, ou le placer a un caractere precis, comme le dixieme caractere). 

fgetc avance le curseur d'un caractere a chaque fois que vous en lisez un. Si vous ap- 
pelez fgetc une seconde fois, la fonction lira done le second caractere, puis le troisieme 
et ainsi de suite. Vous pouvez done faire une boucle pour lire les caracteres un par un 
dans le fichier. 

On va ecrire un code qui lit tous les caracteres d'un fichier un a un et qui les ecrit a 
chaque fois a l'ecran. La boucle s'arrete quand fgetc renvoie EOF (qui signifie « End 
Of File », e'est-a-dire « fin du fichier »). 

int main (int argc, char *argv[]) 
{ 

FILE* fichier = NULL; 

int caractereActuel = 0; 

fichier = f open("test . txt" , "r"); 

if (fichier != MULL) 
{ 

// Boucle de lecture des caracteres un a un 

do 

{ 

caractereActuel = fgetc (fichier) ; // On lit le caractere 
printf ("*/,c" , caractereActuel); // On l'affiche 
} while (caractereActuel != EOF); // On continue tant que fgetc n'a pas 
<->• retourne EOF (fin de fichier) 

f close (fichier) ; 
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} 

return 0; 

> ( Code web : 732632 ) 

La console affichera tout le contenu du fichier, par exemple : 



Coucou, je suis le contenu du fichier test.txt ! 



fgets 

Cette fonction lit une chaine dans le fichier. Qa vous evite d'avoir a lire tous les carac- 
teres un par un. La fonction lit au maximum une ligne (elle s'arrete au premier \n 
qu'elle rencontre). Si vous voulez lire plusieurs lignes, il faudra faire une boucle. 

Void le prototype de fgets : 

I char* fgets (char* chaine, int nbreDeCaracteresALire, FILE* pointeurSurFichier) ; 

Cette fonction demande un parametre un peu particulier, qui va en fait s'averer tres 
pratique : le nombre de caracteres a lire. Cela demande a la fonction fgets de s'arreter 
de lire la ligne si elle contient plus de X caracteres. Avantage : <ja nous permet de nous 
assurer que l'on ne fera pas de depassement de memoire! En effet, si la ligne est trop 
grosse pour rentrer dans chaine, la fonction aurait lu plus de caracteres qu'il n'y a de 
place, ce qui aurait probablement provoque un plantage du programme. 

Nous allons d'abord voir comment lire une ligne avec fgets (nous verrons ensuite 
comment lire tout le fichier). 

Pour cela, on cree une chaine sufHsamment grande pour stocker le contenu de la ligne 
qu'on va lire 2 . Vous allez voir la tout l'interet d'utiliser un define pour definir la taille 
du tableau : 

#define TAILLE_MAX 1000 // Tableau de taille 1000 

int main(int argc, char *argv[]) 
{ 

FILE* fichier = NULL; 

char chaine [TAILLE_MAX] = ""; // Chaine vide de taille TAILLE_MAX 

fichier = fopenCtest.txt", "r") ; 

if (fichier != NULL) 
{ 

fgets(chaine, TAILLE_MAX, fichier); // On lit maximum TAILLE_MAX 



2. Du moins on Fespere, car on ne peut pas en etre sur a 100 %. 
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°-> caracteres du fichier, on stocke le tout dans "chaine" 

printf ("'/,s" , chaine); // On affiche la chaine 

f close (fichier) ; 
} 

return ; 



> ( Code web : 830992 ) 



Le resultat est le meme que pour le code de tout a l'heure, a savoir que le contenu 
s'ecrit dans la console : 



Coucou, je suis le contenu du fichier test.txt ! | 

La difference, c'est qu'ici on ne fait pas de boucle. On affiche toute la chaine d'un coup. 

Vous aurez surement remarque maintenant l'interet que peut avoir un #def ine dans 
son code pour definir la taille maximale d'un tableau par exemple. En effet, TAILLE_MAX 
est ici utilise a deux endroits du code : 

- une premiere fois pour definir la taille du tableau a creer ; 

- une autre fois dans le f gets pour limiter le nombre de caracteres a lire. 

L'avantage ici, c'est que si vous vous rendez compte que la chaine n'est pas assez grande 
pour lire le fichier, vous n'avez qu'a changer la ligne du define et recompiler. Cela vous 
evite d'avoir a chercher tous les endroits du code qui indiquent la taille du tableau. Le 
preprocesseur remplacera tous les TAILLE_MAX dans le code par leur nouvelle valeur. 

Comme je vous l'ai dit, f gets lit au maximum toute une ligne a la fois. Elle s'arrete 
de lire la ligne si elle depasse le nombre maximum de caracteres que vous autorisez. 

Oui mais voila : pour le moment, on ne sait lire qu'une seule ligne a la fois avec f gets. 
Comment diable lire tout le fichier ? La reponse est simple : avec une boucle ! 

La fonction fgets renvoie NULL si elle n'est pas parvenue a lire ce que vous avez 
demande. La boucle doit done s'arreter des que fgets se met a renvoycr NULL. 

On n'a plus qu'a faire un while pour boucler tant que fgets ne renvoie pas NULL : 

#define TAILLE_MAX 1000 

int main(int argc, char *argv[]) 
{ 

FILE* fichier = NULL; 

char chaine [TAILLE_MAX] = ""; 

fichier = f open("test . txt" , "r"); 

if (fichier != NULL) 
{ 

while (fgets (chaine, TAILLE_MAX, fichier) != NULL) // On lit le fichier 
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<—} tant qu'on ne regoit pas d'erreur (NULL) 

{ 

printf ("*/,s" , chaine) ; // On affiche la chaine qu'on vient de lire 
} 

f close(f ichier) ; 
} 

return 0; 



> ( Code web : 499793 ) 

Ce code source lit et affiche tout le contenu de mon fichier, ligne par ligne. 

La ligne de code la plus interessante est celle du while : 

| while (f gets (chaine, TAILLE_MAX, fichier) != NULL) 

La ligne du while fait deux choses : elle lit une ligne dans le fichier et verifie si fgets 
ne renvoie pas NULL. Elle peut done se traduire comme ceci : « Lire une ligne du fichier 
tant que nous ne sommes pas arrives a la fin du fichier ». 



f scanf 

C'est le meme principe que la fonction scanf, la encore. Cette fonction lit dans un 
fichier qui doit avoir ete ecrit d'une maniere precise. 

Supposons que votre fichier contienne trois nombres separes par un espace, qui sont 
par exemple les trois plus hauts scores obtenus a votre jeu : 15 20 30. 

Vous voudriez recuperer chacun de ces nombres dans une variable de type int. La 
fonction f scanf va vous permettre de faire <ja rapidement. 

int main(int argc, char *argv[]) 
{ 

FILE* fichier = NULL; 

int score [3] = {0}; // Tableau des 3 meilleurs scores 

fichier = fopenCtest.txt", "r") ; 

if (fichier != NULL) 
{ 

f scanf (fichier, "*/,d */,d */,d" , &score[0], &score[l], &score[2]); 

printf ("Les meilleurs scores sont : */,d, */,d et */,d" , score[0], score[l], 
<-¥ score[2]); 



fclose(f ichier) ; 



} 
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return ; 



> [ Code web : 530561 ) 



Les meilleurs scores sont : 15, 20 et 30 



Comme vous le voyez, la fonction f scanf attend trois nombres separes par un espace 
("°/.d 7„d 7„d"). Elle les stocke ici dans notre tableau de trois blocs. 

On affiche ensuite chacun des nombres recuperes. 

Jusqu'ici, je ne vous avais fait mettre qu'un seul °/„d entre guillemets pour la 
fonction scanf. Vous decouvrez aujourd'hui qu'on peut en mettre plusieurs, 
les combiner. Si votre fichier est ecrit d'une facon bien precise, cela permet 
d'aller plus vite pour recuperer chacune des valeurs. 




a 



Se deplacer dans un fichier 

Je vous ai parle d'une espece de « curseur » virtuel tout a l'heure. Nous allons l'etudier 
maintenant plus en details. 

Chaque fois que vous ouvrez un fichier, il existe en effet un curseur qui indique votre 
position dans le fichier. Vous pouvez imaginer que c'est exactement comme le curseur 
de votre editeur de texte (tel Bloc-Notes). II indique ou vous etes dans le fichier, et 
done ou vous allez ecrire. 

En resume, le systeme de curseur vous permet d'aller lire et ecrire a une position precise 
dans le fichier. 

II existe trois fonctions a connaitre : 

- ftell : indique a quelle position vous etes actuellement dans le fichier; 

- f seek : positionne le curseur a un endroit precis ; 

- rewind : remet le curseur au debut du fichier (c'est equivalent a demander a la 
fonction fseek de positionner le curseur au debut). 



ftell : position dans le fichier 

Cette fonction est tres simple a utiliser. Elle renvoie la position actuelle du curseur 
sous la forme d'un long : 

I long ftell (FILE* pointeurSurFichier) ; 

Le nombre renvoye indique done la position du curseur dans le fichier. 
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f seek : se positionner dans le fichier 

Le prototype de f seek est le suivant : 

lint fseek(FILE* pointeurSurFichier , long deplacement , int origine) ; 

La fonction f seek permet de deplacer le curseur d'un certain nombre de caracteres 
(indique par deplacement) a partir de la position indiquee par origine. 

- Le nombre deplacement peut etre un nombre positif (pour se deplacer en avant), 
mil (= 0) ou negatif (pour se deplacer en arriere). 

- Quant au nombre origine, vous pouvez mettre comme valeur l'une des trois constantes 
(generalement des define) listees ci-dessous : 

- SEEK_SET : indique le debut du fichier ; 

- SEEK_CUR : indique la position actuelle du curseur ; 

- SEEK_END : indique la fin du fichier. 

Voici quelques exemples pour bien comprendre comment on jongle avec deplacement 
et origine. 

- Le code suivant place le curseur deux caracteres apres le debut : 
|fseek(fichier, 2, SEEK_SET) ; 

- Le code suivant place le curseur quatre caracteres avant la position courante : 
| fseek(fichier, -4, SEEK_CUR) ; 

Remarquez que deplacement est negatif car on se deplace en arriere. 

- Le code suivant place le curseur a la fin du fichier : 

|fseek(fichier, 0, SEEK_END) ; 

Si vous ecrivez apres avoir fait un f seek qui mene a la fin du fichier, cela ajoutera vos 
informations a la suite dans le fichier (le fichier sera complete). En revanche, si vous 
placez le curseur au debut et que vous ecrivez, cela ecrasera le texte qui se trouvait la. 
II n'y a pas de moyen d'« inserer » de texte dans le fichier 3 . 

m Mais comment puis-je savoir a quelle position je dois aller lire et ecrire dans 
J le fichier? 

C'est a vous de le gerer. Si c'est un fichier que vous avez vous-memes ecrit, vous savez 
comment il est construit. Vous savez done ou aller chercher vos informations : par 
exemple les meilleurs scores sont en position 0, les noms des derniers joueurs sont en 
position 50, etc. 

Nous travaillerons sur un TP un peu plus tard dans lequel vous comprendrez, si ce n'est 
pas deja le cas, comment on fait pour aller chercher l'information qui nous interesse. 




3. A moins de coder soi-meme une fonction qui lit les caracteres d'apres pour s'en souvenir avant 
de les ecraser ! 
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N'oubliez pas que c'est vous qui definissez comment votre fichier est construit. C'est 
done a vous de dire : « je place le score du meilleur joueur sur la premiere ligne, celui 
du second meilleur joueur sur la seconde ligne, etc. » 



A 



La fonction f seek peut se comporter bizarrement sur des fichiers ouverts en 
mode texte. En general, on I 'utilise plutot pour se deplacer dans des fichiers 
ouverts en mode binaire. Quand on lit et ecrit dans un fichier en mode texte, 
on le fait generalement caractere par caractere. La seule chose qu'on se permet 
en mode texte avec f seek c'est de revenir au debut ou de se placer a la fin. 



rewind : retour au debut 

Cette fonction est equivalente a utiliser f seek pour nous renvoyer a la position dans 
le fichier. 

I void rewind (FILE* pointeurSurFichier) ; 

L'utilisation est aussi simple que le prototype. Vous n'avez pas besoin d'explication 
supplementaire ! 



Renomraer et supprimer un fichier 

Nous terminerons ce chapitre en douceur par l'etude de deux fonctions tres simples : 

- rename : renomme un fichier ; 

- remove : supprime un fichier. 

La particularity de ces fonctions est qu'elles ne necessitent pas de pointeur de fichier 
pour fonctionner. II suffira simplement d'indiquer le nom du fichier a renommer ou 
supprimer. 

rename : renommer un fichier 

Voici le prototype de cette fonction : 

I int rename (const char* ancienNom, const char* nouveauNom) ; 

La fonction renvoie si elle a reussi a renommer, sinon elle renvoie une valeur differente 
de 0. Est-il necessaire de vous donner un exemple ? En voici un : 

int main (int argc, char *argv[]) 
{ 

rename ("test . txt" , "test_renomme.txt") ; 

return ; 
} 
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remove : supprimer un fichier 

Cette fonction supprime un fichier sans demander son reste : 
lint remove (const char* f ichierASupprimer) ; 



© 



Faites tres attention en utilisant cette fonction ! Elle supprime le fichier indique 
sans demander de confirmation ! Le fichier n'est pas mis dans la corbeille, il 
est litteralement supprime du disque dur. II n'est pas possible de recuperer 
un tel fichier supprime 4 . 



Cette fonction tombe a pic pour la fin du chapitre, je n'ai justement plus besoin du 
fichier test .txt, je peux done me permettre de le supprimer : 

int main(int argc, char *argv[]) 
{ 

remove ( "test . txt " ) ; 

return 0; 
} 



4. A moins de faire appel a des outils specifiques de recuperation de fichiers sur le disque, mais 
Foperation peut etre longue, complexe et ne pas reussir. 
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17 



L'allocation dynamique 



Toutes les variables que nous avons creees jusqu'ici etaient construites automatique- 
ment par le compilateur du langage C. C'etait la methode simple. II existe cependant 
une facon plus manuelle de creer des variables que Ton appelle l'allocation dynamique. 

Un des principaux interets de l'allocation dynamique est de permettre a un programme de 
reserver la place necessaire au stockage d'un tableau en memoire dont il ne connaissait 
pas la taille avant la compilation. En effet, jusqu'ici, la taille de nos tableaux etait fixee 
« en dur » dans le code source. Apres lecture de ce chapitre, vous allez pouvoir creer des 
tableaux de facon bien plus flexible I 

II est imperatif de bien savoir manipuler les pointeurs pour pouvoir lire ce chapitre! Si 
vous avez encore des doutes sur les pointeurs, je vous recommande d'aller relire le chapitre 
correspondant avant de commencer. 



K 
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Quand on declare une variable, on dit qu'on demande a allouer de la memoire : 

I int monN ombre = 0; 

Lorsque le programme arrive a une ligne comme celle-ci, il se passe en fait les choses 
suivantes : 

1. votre programme demande au systeme d'exploitation (Windows, Linux, Mac 
OS. . .) la permission d'utiliser un peu de memoire ; 

2. le systeme d'exploitation repond a votre programme en lui indiquant ou il peut 
stocker cette variable (il lui donne l'adresse qu'il lui a reservee) ; 

3. lorsque la fonction est terminee, la variable est automatiquement supprimee de la 
memoire. Votre programme dit au systeme d'exploitation : « Je n'ai plus besoin 
de l'espace en memoire que tu m'avais reserve a telle adresse, merci ! 1 ». 

Jusqu'ici, les choses etaient automatiques. Lorsqu'on declarait une variable, le systeme 
d'exploitation etait automatiquement appele par le programme. Que diriez-vous de 
faire cela manuellement ? Non pas par pur plaisir de faire quelque chose de complique 
(meme si c'est tentant!), mais plutot parce que nous allons parfois etre obliges de 
proceder comme cela. 

Dans ce chapitre, nous allons : 

- etudier le fonctionnement de la memoire (oui, encore!) pour decouvrir la taille que 
prend une variable en fonction de son type ; 

- puis attaquer le sujet lui- meme : nous verrons comment demander manuellement 
de la memoire au systeme d'exploitation. On fera ce qu'on appelle de l'allocation 
dynamique de memoire ; 

- enfin, decouvrir l'interet de faire une allocation dynamique de memoire en apprenant 
a creer un tableau dont la taille n'est connue qu'a l'execution du programme. 

La taille des variables 

Selon le type de variable que vous demandez de creer (char, int, double, float. . .), 
vous avez besoin de plus ou moins de memoire. 

En effet, pour stocker un nombre compris entre -128 et 127 (un char), on n'a besoin 
que d'un octet en memoire. C'est tout petit. En revanche, un int occupe generalement 
4 octets en memoire. Quant au double, il occupe 8 octets. 

Le probleme est. . . que ce n'est pas toujours le cas. Cela depend des machines : peut- 
etre que chez vous un int occupe 8 octets, qui sait ? Notre objectif ici est de verifier 
quelle taille occupe chacun des types sur votre ordinateur. 

II y a un moyen tres facile pour savoir cela : utiliser l'operateur sizeof (). Contrai- 
rement aux apparences, ce n'est pas une fonction mais une fonctionnalite de base du 



1. L'histoire ne precise pas si le programme dit vraiment « merci » a FOS, mais c'est tout dans son 
interet parce que c'est FOS qui controle la memoire ! 
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langage C. Vous devez juste indiquer entre parentheses le type que vous voulez analyser. 
Pour connaitre la taille d'un int, on devra done ecrire : 

I sizeof (int) 

A la compilation, cela sera remplace par un nombre : le nombre d'octets que prend int 
en memoire. Chez moi, sizeof (int) vaut 4, ce qui signifie que int occupe 4 octets. 
Chez vous, e'est probablement la meme valeur, mais ce n'est pas une regie. Testez pour 
voir, en affichant la valeur a l'aide d'un printf par exemple : 

printf("char : */,d octets\n", sizeof (char) ) ; 
printf ("int : '/,d octets\n", sizeof (int) ) ; 
printf ("long : '/,d octets\n", sizeof (long) ) ; 
printf ("double : */,d octets\n", sizeof (double) ) ; 

Chez moi, cela affiche : 



char 


1 


octets 


int : 


4 octets 


long 


4 


octets 


double : 


8 octets 



Je n'ai pas mis tous les types que nous connaissons, je vous laisse le soin de tester 
vous-memes la taille des autres types. 

Vous remarquerez que long et int occupent la meme place en memoire. Creer un long 
revient done ici exactement a creer un int, cela prend 4 octets dans la memoire. 

En fait, le type long est equivalent a un type appele long int, qui est ici 
equivalent au type. . . int. Bref, ca fait beaucoup de noms differents pour 
pas grand-chose, au final I Avoir de nombreux types differents etait utile a 
une epoque ou Ton n'avait pas beaucoup de memoire dans nos ordinateurs. 
On cherchait a utiliser le minimum de memoire possible en utilisant le type 
le plus adapte. Aujourd'hui, cela ne sert plus vraiment car la memoire d'un 
ordinateur est tres grande 2 . 




a 




) Peut-on afficher la taille d'un type personnalise qu'on a cree (une structure) ? 



O 



Oui ! sizeof marche aussi sur les structures ! 

typedef struct Coordonnees Coordonnees; 
struct Coordonnees 

2. En revanche, tous ces types ont encore de Finteret si vous creez des programmes pour de l'infor- 
matique embarquee ou la memoire disponible est plus faible. Je pense par exemple aux programmes 
destines a des telephones portables, a des robots, etc. 
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{ 

int x; 

int y; 

}; 

int main(int argc, char *argv[]) 
{ 

printf ("Coordonnees : */,d octets\n", sizeof (Coordonnees) ) ; 

return 0; 
} 



Coordonnees : 8 octets 



Plus une structure contient de sous- variables, plus elle prend de memoire. Terriblement 
logique, n'est-ce pas ? 

Une nouvelle facon de voir la memoire 

Jusqu'ici, mes schemas de memoire etaient encore assez imprecis. On va enfin pouvoir 
les rendre vraiment precis et corrects maintenant qu'on connait la taille de chacun des 
types de variables. 

Si on declare une variable de type int : 

I int nombre = 18 ; 

. . . et que sizeof (int) indique 4 octets sur notre ordinateur, alors la variable occupera 
4 octets en memoire ! 

Supposons que la variable nombre soit allouee a l'adresse 1600 en memoire. On aurait 
alors le schema de la fig. 17.1. 

Ici, on voit bien que notre variable nombre de type int qui vaut 18 occupe 4 octets dans 
la memoire. Elle commence a l'adresse 1600 (c'est son adresse) et termine a l'adresse 
1603. La prochaine variable ne pourra done etre stockee qu'a partir de l'adresse 1604 ! 

Si on avait fait la meme chose avec un char, on n'aurait alors occupe qu'un seul octet 
en memoire (fig. 17.2). 

Imaginez maintenant un tableau de int ! Chaque « case » du tableau occupera 4 octets. 
Si notre tableau fait 100 cases : 

| int tableau [100] ; 

on occupera alors en realite 4 * 100 = 400 octets en memoire. 




) Meme si le tableau est vide, il prend 400 octets? 
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Adresse 



1599 



1600 



1601 



1602 



1603 



1604 



1 



Valeur 



18 



Figure 17.1 - Un int occupant 4 octets en memoire 



Adresse 



1599 



1600 



1601 



1602 



1603 



1604 



1 



Valeur 



18 



Figure 17.2 - Un char occupant 1 octet en memoire 
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Bien sur ! La place en memoire est reservee, aucun autre programme n'a le droit d'y tou- 
cher (a part le votre). Une fois qu'une variable est declaree, elle prend immediatement 
de la place en memoire. 

Notez que si on cree un tableau de type Coordonnees : 

I Coordonnees tableau [100] ; 

... on utilisera cette fois : 8 * 100 = 800 octets en memoire. 

II est important de bien comprendre ces petits calculs pour la suite du chapitre. 

Allocation de memoire dynamique 

Entrons maintenant dans le vif du sujet. Je vous rappelle notre objectif : apprendre a 
demander de la memoire manuellement. 

On va avoir besoin d'inclure la bibliotheque <stdlib.h> 3 . Cette bibliotheque contient 
deux fonctions dont nous allons avoir besoin : 

- malloc (« Memory ALLOCation », c'est-a-dire « Allocation de memoire ») : demande 
au systeme d'exploitation la permission d'utiliser de la memoire ; 

- free (« Liberer ») : permet d'indiquer a l'OS que l'on n'a plus besoin de la memoire 
qu'on avait demandee. La place en memoire est liberee, un autre programme peut 
maintenant s'en servir au besoin. 

Quand vous faites une allocation manuelle de memoire, vous devez toujours suivre ces 
trois etapes : 

1. appeler malloc pour demander de la memoire; 

2. verifier la valeur retournee par malloc pour savoir si l'OS a bien reussi a allouer 
la memoire ; 

3. une fois qu'on a fini d'utiliser la memoire, on doit la liberer avec free. Si on ne 
le fait pas, on s'expose a des fuites de memoire, c'est-a-dire que votre programme 
risque au final de prendre beaucoup de memoire alors qu'il n'a en realite plus 
besoin de tout cet espace. 

Ces trois etapes vous rappellent-elles le chapitre sur les fichiers ? Elles devraient ! Le 
principe est exactement le meme qu'avec les fichiers : on alloue, on verifie si l'allocation 
a marche, on utilise la memoire, puis on la libere quand on a fini de l'utiliser. 



malloc : demande d'allocation de memoire 

Le prototype de la fonction malloc est assez comique, vous allez voir : 



3. Si vous avez suivi mes conseils, vous devriez avoir inclus cette bibliotheque dans tous vos pro- 
grammes, de toute facon. 
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I void* malloc(size_t nombreOctetsNecessaires) ; 

La fonction prend un parametre : le nombre d'octets a reserver. Ainsi, il suffira d'ecrire 
sizeof (int) dans ce parametre pour reserver suffisamment d'espace pour stocker un 
int. 

Mais c'est surtout ce que la fonction renvoie qui est curieux : elle renvoie un. . . void* ! 
Si vous vous souvenez du chapitre sur les fonctions, je vous avais dit que void signifiait 
« vide » et qu'on utilisait ce type pour indiquer que la fonction ne retournait aucune 
valeur. 

Alors ici, on aurait une fonction qui retourne un. . . « pointeur sur vide » ? En voila une 
bien bonne ! Ces programmeurs ont decidement un sens de l'humour tres developpe. 

Rassurez-vous, il y a une raison. En fait, cette fonction renvoie un pointeur indiquant 
l'adresse que l'OS a reservee pour votre variable. Si l'OS a trouve de la place pour vous 
a l'adresse 1600, la fonction renvoie done un pointeur contenant l'adresse 1600. 

Le probleme, c'est que la fonction malloc ne sait pas quel type de variable vous cherchez 
a creer. En effet, vous ne lui donnez qu'un parametre : le nombre d'octets en memoire 
dont vous avez besoin. Si vous demandez 4 octets, <ja pourrait aussi bien etre un int 
qu'un long par exemple ! 

Comme malloc ne sait pas quel type elle doit retourner, elle renvoie le type void*. Ce 
sera un pointeur sur n'importe quel type. On peut dire que c'est un pointeur universel. 

Passons a la pratique. Si je veux m'amuser (hum !) a creer manuellement une variable 
de type int en memoire, je devrais indiquer a malloc que j'ai besoin de sizeof (int) 
octets en memoire. Je recupere le resultat du malloc dans un pointeur sur int. 

int* memoireAllouee = NULL; // On cree un pointeur sur int 

memoireAllouee = malloc(sizeof (int) ) ; // La fonction malloc inscrit dans notre 
M> pointeur l'adresse qui a ete reservee. 

A la fin de ce code, memoireAllouee est un pointeur contenant une adresse qui vous 
a ete reservee par l'OS, par exemple l'adresse 1600 pour reprendre mes schemas prece- 
dents. 

Tester le pointeur 

La fonction malloc a done renvoye dans notre pointeur memoireAllouee l'adresse qui 
a ete reservee pour vous en memoire. Deux possibilites : 

- si l'allocation a marche, notre pointeur contient une adresse ; 

- si l'allocation a echoue, notre pointeur contient l'adresse NULL. 

II est peu probable qu'une allocation echoue, mais cela peut arriver. Imaginez que vous 
demandiez a utiliser 34 Go de memoire vive, il y a tres peu de chances que l'OS vous 
reponde favorablement. 
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II est neanmoins recommande de toujours tester si l'allocation a marche. On va faire 
ceci : si l'allocation a echoue, c'est qu'il n'y avait plus de memoire de libre (c'est un cas 
critique). Dans un tel cas, le mieux est d'arreter immediatement le programme parce 
que, de toute maniere, il ne pourra pas continuer convenablement. 

On va utiliser une fonction standard qu'on n'avait pas encore vue jusqu'ici : exit(). 
Elle arrete immediatement le programme. Elle prend un parametre : la valeur que le 
programme doit retourner 4 . 

int main(int argc, char *argv[]) 
{ 

int* memoireAllouee = NULL; 

memoireAllouee = malloc(sizeof (int) ) ; 

if (memoireAllouee == NULL) // Si l'allocation a echoue 

{ 

exit(O); // On arrete immediatement le programme 
} 

// On peut continuer le programme normalement sinon 

return 0; 



Si le pointeur est different de NULL, le programme peut continuer, sinon il faut afficher 
un message d'erreur ou m6me mettre fin au programme, parce qu'il ne pourra pas 
continuer correctement s'il n'y a plus de place en memoire. 

free : liberer de la memoire 

Tout comme on utilisait la fonction f close pour fermer un fichier dont on n'avait plus 
besoin, on va utiliser la fonction free pour liberer la memoire dont on ne se sert plus. 

I void free (void* pointeur); 

La fonction free a juste besoin de l'adresse memoire a liberer. On va done lui envoyer 
notre pointeur, e'est-a-dire memoireAllouee dans notre exemple. Voici le schema com- 
plet et final, ressemblant a s'y meprendre a ce qu'on a vu dans le chapitre sur les 
fichiers : 

int main(int argc, char *argv[]) 
{ 

int* memoireAllouee = NULL; 

memoireAllouee = malloc(sizeof (int) ) ; 

if (memoireAllouee == NULL) // On verifie si la memoire a ete allouee 



4. Cela correspond en fait au return du mainQ. 
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{ 

exit(O); // Erreur : on arrete tout ! 
} 

// On peut utiliser ici la memoire 

free(memoireAllouee) ; // On n'a plus besoin de la memoire, on la libere 

return ; 



Exemple concret d'utilisation 

On va programmer quelque chose qu'on a appris a faire il y a longtemps : demander 
Page de l'utilisateur et le lui afficher. La seule difference avec ce qu'on faisait avant, c'est 
qu'ici la variable va etre allouee manuellement (on dit aussi dynamiquement) plutot 
qu'automatiquement comme auparavant. Alors oui, du coup, le code est un peu plus 
complique. Mais faites l'effort de bien le comprendre, c'est important : 



int main(int argc, char *argv[]) 
{ 

int* memoireAllouee = NULL; 

memoireAllouee = malloc(sizeof (int) ) ; // Allocation de la memoire 

if (memoireAllouee == NULL) 

{ 

exit(O) ; 
} 

// Utilisation de la memoire 

printf("Quel age avez-vous ? ") ; 

scanf ("*/,d" , memoireAllouee); 

printf("Vous avez */,d ans\n" , *memoireAllouee) ; 

free (memoireAllouee) ; // Liberation de memoire 

return ; 



t> ( Code web : 294774 ) 



Quel age avez-vous ? 31 

Vous avez 31 axis 
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Attention : comme memoireAllouee est un pointeur, on ne I ' utilise pas de 
la meme maniere qu'une vraie variable. Pour obtenir la valeur de la variable, 
il faut placer une etoile devant : *memoireAllouee (regardez le printf). 
Tandis que pour indiquer I'adresse, on a juste besoin d'ecrire le nom du 
pointeur memoireAllouee (regardez le scanf ). Tout cela a ete explique dans 
le chapitre sur les pointeurs. Toutefois, on met generalement du temps a s'y 
faire et il est probable que vous confondiez encore. Si c'est votre cas, vous 
devez relire le chapitre sur les pointeurs, qui est fondamental. 



A 



Revenons a notre code. On y a alloue dynamiquement une variable de type int. Au 
final, ce qu'on a ecrit revient exactement au meme que d'utiliser la methode « auto- 
matique » qu'on connait bien maintenant : 



int main(int argc, char *argv[]) 
{ 

int maVariable =0; // Allocation de la memoire (automatique) 

// Utilisation de la memoire 

printf ("Quel age avez-vous ? "); 

scanf C"/.d", fanaVariable) ; 

printf ("Vous avez */,d ans\n", maVariable); 

return 0; 
} // Liberation de la memoire (automatique a la fin de la fonction) 



Quel age avez-vous ? 31 
Vous avez 31 ans 



En resume, il y a deux facons de creer une variable, c'est-a-dire d'allouer de la memoire. 
Soit on le fait : 

- automatiquement : c'est la methode que vous connaissez et qu'on a utilisee jusqu'ici ; 

- manuellement (dynamiquement) : c'est la methode que je vous enseigne dans ce 
chapitre. 



Je trouve la methode dynamique compliquee et inutile! 




Un peu plus compliquee. . . certes. Mais inutile, non ! Nous sommes parfois obliges 
d'allouer manuellement de la memoire, comme nous allons le voir maintenant. 
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Allocation dynamique d'un tableau 

Pour le moment, on a utilise l'allocation dynamique uniquement pour creer une petite 
variable. Or en general, on ne se sert pas de l'allocation dynamique pour cela. On utilise 
la methode automatique qui est plus simple. 

Quand a-t-on besoin de l'allocation dynamique, me direz-vous? Le plus souvent, on 
s'en sert pour creer un tableau dont on ne connait pas la taille avant l'execution du 
programme. 

Imaginons par exemple un programme qui stocke l'age de tous les amis de l'utilisateur 
dans un tableau. Vous pourriez creer un tableau de int pour stocker les ages, comme 
ceci : 

I int ageAmis [15] ; 

Mais qui vous dit que l'utilisateur a 15 amis ? Peut-etre qu'il en a plus que <ja ! Lorsque 
vous ecrivez le code source, vous ne connaissez pas la taille que vous devez donner a 
votre tableau. Vous ne le saurez qu'a l'execution, lorsque vous demanderez a l'utilisateur 
combien il a d'amis. 

L'interet de l'allocation dynamique est la : on va demander le nombre d'amis a l'utili- 
sateur, puis on fera une allocation dynamique pour creer un tableau ayant exactement 
la taille necessaire (ni trop petit, ni trop grand). Si l'utilisateur a 15 amis, on creera 
un tableau de 15 int ; s'il en a 28, on creera un tableau de 28 int, etc. 

Comme je vous l'ai appris, il est interdit en C de creer un tableau en indiquant sa taille 
a l'aide d'une variable : 



I int amis [nombreDAmis] ; 




a 



Ce code fonctionne peut-etre sur certains compilateurs mais uniquement dans 
des cas precis, il est recommande de ne pas I'utiliser! 



L'avantage de l'allocation dynamique, e'est qu'elle nous permet de creer un tableau 
qui a exactement la taille de la variable nombreDAmis, et cela grace a un code qui 
fonctionnera partout ! 

On va demander au malloc de nous reserver nombreDAmis * sizeof (int) octets en 
memoire : 

I amis = malloc (nombreDAmis * sizeof (int) ) ; 

Ce code permet de creer un tableau de type int qui a une taille correspondant exac- 
tement au nombre d'amis ! 

Voici ce que fait le programme dans l'ordre : 
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1. demander a l'utilisateur combien il a d'amis ; 

2. creer un tableau de int ayant une taille egale a son nombre d'amis (via malloc) ; 

3. demander Page de chacun de ses amis un a un, qu'on stocke dans le tableau ; 

4. afficher Page des amis pour montrer qu'on a bien memorise tout cela ; 

5. a la fin, puisqu'on n'a plus besoin du tableau contenant Page des amis, le liberer 
avec la fonction free. 

int main(int argc, char *argv[]) 
{ 

int nombreDAmis =0, i = 0; 

int* ageAmis = NULL; // Ce pointeur va servir de tableau apres l'appel du 
«— ¥ malloc 

// On demande le nombre d'amis a l'utilisateur 
printf ("Combien d'amis avez-vous ? ") ; 
scanf ("*/,d" , ftnombreDAmis) ; 

if (nombreDAmis > 0) // II faut qu'il ait au moins un ami (je le plains un 
<— >• peu sinon :p) 
{ 

ageAmis = malloc (nombreDAmis * sizeof (int) ) ; // On alloue de la memoire 
<—¥ pour le tableau 

if (ageAmis == NULL) // On verifie si 1 'allocation a marche ou non 
{ 

exit(0); // On arrete tout 
} 

// On demande 1'a.ge des amis un a un 
for (i = ; i < nombreDAmis ; i++) 
{ 

printf ("Quel age a l'ami numero */,d ? " , i + 1) ; 

scanf ("*/,d" , ftageAmis [i] ) ; 
} 

// On affiche les ages stockes un a un 

printf ("\n\nVos amis ont les ages suivants :\n"); 

for (i = ; i < nombreDAmis ; i++) 

{ 

printf ("*/,d ans\n", ageAmis [i] ) ; 
} 

// On libere la memoire allouee avec malloc, on n'en a plus besoin 
free (ageAmis) ; 
} 

return 0; 



} 

> ( Code web : 423350 ) 
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Combien d'amis avez-vous ? 5 
Quel age a l'ami numero 1 ? 16 
Quel age a l'ami numero 2 ? 18 
Quel age a l'ami numero 3 ? 20 
Quel age a l'ami numero 4 ? 26 
Quel age a l'ami numero 5 ? 27 

Vos amis ont les ages suivants 
16 ans 
18 ans 
20 ans 

26 ans 

27 ans 



Ce programme est tout a fait inutile : il demande les ages et les affiche ensuite. J'ai 
choisi de faire cela car c'est un exemple « simple » (enfin, si vous avez compris le 
malloc). 

Je vous rassure : dans la suite du cours, nous aurons l'occasion d'utiliser le malloc 
pour des choses bien plus interessantes que le stockage de Page de ses amis ! 



En resume 

- Une variable occupe plus ou moins d'espace en memoire en fonction de son type. 

- On peut connaitre le nombre d'octets occupes par un type a l'aide de l'operateur 
sizeof () . 

- L'allocation dynamique consiste a reserver manuellement de l'espace en memoire 
pour une variable ou un tableau. 

- L'allocation est effectuee avec malloc () et il ne faut surtout pas oublier de liberer 
la memoire avec free() des qu'on n'en a plus besoin. 

- L'allocation dynamique permet notamment de creer un tableau dont la taille est 
determinee par une variable au moment de l'execution. 
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TP : realisation d'un Pendu 



Je ne le repeterai jamais assez : pratiquer est essentiel. C'est d'autant plus essentiel 
pour vous car vous venez de decouvrir de nombreux concepts theoriques et, quoi que 
vous en disiez, vous ne les aurez jamais vraiment compris tant que vous n'aurez pas 
pratique. 

Pour ce TP, je vous propose de realiser un Pendu. C'est un grand classique des jeux de 
lettres dans lequel il faut deviner un mot cache lettre par lettre. Le Pendu aura done la 
forme d'un jeu en console en langage C. 

L'objectif est de vous faire manipuler tout ce que vous avez appris jusqu'ici. Au menu : 
pointeurs, chames de caracteres, fichiers, tableaux. . . bref, que des bonnes choses I 
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Les consignes 

Je tiens a ce qu'on se mette bien d'accord sur les regies du Pendu a realiser. Je vais 
done vous dormer ici les consignes, e'est-a-dire vous expliquer comment doit fonctionner 
precisement le jeu que vous allez creer. 

Tout le monde connait le Pendu, n'est-ce pas ? Allez, un petit rappel ne peut pas faire 
de mal : le but du Pendu est de retrouver un mot cache en moins de 10 essais 1 . 



Deroulement d'une partie 

Supposons que le mot cache soit ROUGE. Vous proposez une lettre a l'ordinateur, par 
exemple la lettre A. L'ordinateur verifie si cette lettre se trouve dans le mot cache. 

Rappelez-vous : il y a unefonction toute prete dans string. h pour rechercher 
une lettre dans un mot ! Notez que vous n'etes cependant pas obliges de 
I'utiliser (personnellement, je ne m'en suis pas servi). 




a 



A partir de la, deux possibilites : 

- la lettre se trouve effectivement dans le mot : dans ce cas, on devoile le mot avec les 
lettres qu'on a deja trouvees ; 

- la lettre ne se trouve pas dans le mot (e'est le cas ici, car A n'est pas dans ROUGE) : 
on indique au joueur que la lettre ne s'y trouve pas et on diminue le nombre de coups 
restants. Quand il ne nous reste plus de coups (0 coup), le jeu est termine et on a 
perdu. 

Dans un « vrai » Pendu, il y aurait normalement le dessin d'un bonhomme 
qui se fait pendre au fur et a mesure que Ton fait des erreurs. En console, 
ce serait un peu trop difficile de dessiner un bonhomme qui se fait pendre 
rien qu'avec du texte, on va done se contenter d'afficher une simple phrase 
comme « II vous reste X coups avant une mort certaine ». 




a 



Supposons maintenant que le joueur tape la lettre G. Celle-ci se trouve dans le mot 
cache, done on ne diminue pas le nombre de coups restants au joueur. On afRche le 
mot secret avec les lettres qu'on a deja decouvertes, e'est-a-dire quelque chose comme 
ga : 



Mot secret : ***G* 



Si ensuite on tape un R, comme la lettre s'y trouve, on l'ajoute a la liste des lettres 
trouvees et on afRche a nouveau le mot avec les lettres deja decouvertes : 



Mot secret : R**G* 



1. Mais vous pouvez changer ce nombre maximal pour corser la difficulte, bien sur! 
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Le cas des lettres multiples 

Dans certains mots, une meme lettre peut apparaitre deux ou trois fois, voire plus ! Par 
exemple, il y a deux Z dans PUZZLE ; de meme, il y a trois E dans ELEMENT. 

Que fait-on dans un cas comme ga ? Les regies du Pendu sont claires : si le joueur tape 
la lettre E, toutes les lettres E du mot ELEMENT doivent etre decouvertes d'un seul 
coup : 



Mot secret : E*E*E** 



II ne faut done pas avoir a taper trois fois la lettre E pour que tous les E soient 
decouverts. 



Exemple d'une partie complete 

Voici a quoi devrait ressembler une partie complete en console lorsque votre programme 
sera termine : 



Bienvenue dans le Pendu ! 

II vous reste 10 coups a jouer 
Quel est le mot secret ? ****** 
Proposez une lettre : E 

II vous reste 9 coups a jouer 
Quel est le mot secret ? ****** 
Proposez une lettre : A 

II vous reste 9 coups a jouer 
Quel est le mot secret ? *A**** 
Proposez une lettre : 

II vous reste 9 coups a jouer 
Quel est le mot secret ? *A**0* 
Proposez une lettre : 



Et ainsi de suite jusqu'a ce que le joueur ait decouvert toutes les lettres du mot (ou 
bien qu'il ne lui reste plus de coups a jouer) : 



II vous reste 8 coups a jouer 
Quel est le mot secret ? MA**0N 
Proposez une lettre : R 

Gagne ! Le mot secret etait bien : MARRON 
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Saisie d'une lettre en console 

La lecture d'une lettre dans la console est plus compliquee qu'il n'y parait. Intuitive- 
ment, pour recuperer un caractere, vous devriez avoir pense a : 

I scanf ("'/,c" , fanaLettre) ; 

Et effect ivement, c'est bien. °/„c indique que l'on attend un caractere, qu'on stockera 
dans maLettre (une variable de type char). 

Tout se passe tres bien... tant qu'on ne refait pas un scanf. En effet, vous pouvez 
tester le code suivant : 

int main(int argc, char* argv[]) 
{ 

char maLettre = 0; 

scanf ("*/,c" , fanaLettre) ; 
printf ("*/,c" , maLettre); 

scanf ("*/,c" , fanaLettre); 
printf C'/.c" , maLettre); 

return ; 



Normalement, ce code est cense vous demander une lettre et vous 1'afRcher, et cela deux 
fois. Testez. Que se passe-t-il? Vous entrez une lettre, d'accord, mais. . . le programme 
s'arrete de suite apres, il ne vous demande pas la seconde lettre ! On dirait qu'il ignore 
le second scanf. 




H Que s'est-il passe? 



En fait, quand vous entrez du texte en console, tout ce que vous tapez est stocke 
quelque part en memoire, y compris I'appui sur la touche Entree (\n). 

Ainsi, la premiere fois que vous entrez une lettre (par exemple A) puis que vous appuyez 
sur Entree, c'est la lettre A qui est renvoyee par le scanf. Mais la seconde fois, scanf 
renvoie le \n correspondant a la touche Entree que vous aviez pressee auparavant ! 

Pour eviter cela, le mieux c'est de creer notre propre petite fonction lireCaractere () : 

char lireCaractere () 
{ 

char caractere = 0; 

caractere = getcharO ; // On lit le premier caractere 
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caractere = toupper(caractere) ; // On met la lettre en majuscule si elle ne 
<— > l'est pas deja 

// On lit les autres caracteres memorises un a un jusqu'au \n (pour les 
<-> effacer) 

while (getcharO != '\n') ; 

return caractere; // On retourne le premier caractere qu'on a lu 
} 

> ( Code web : 764168 ) 

Cette fonction utilise getcharO qui est une fonction de stdio qui revient exactement a 
ecrire scanf ("7,c" , felettre) ; . La fonction getchar renvoie le caractere que le joueur 
a tape. 

Apres, j 'utilise une fonction standard qu'on n'a pas eu l'occasion d'etudier dans le 
cours : toupper(). Cette fonction transforme la lettre indiquee en majuscule. Comme 
ga, le jeu fonctionnera meme si le joueur tape des lettres minuscules. II faudra inclure 
ctype.h pour pouvoir utiliser cette fonction (ne l'oubliez pas!). 

Vient ensuite la partie la plus interessante : celle ou je vide les autres caracteres qui 
auraient pu avoir ete tapes. En effet, en rappelant getchar on prend le caractere suivant 
que l'utilisateur a tape (par exemple V Entree \n). Ce que je fais est simple et tient en 
une ligne : j'appelle la fonction getchar en boucle jusqu'a tomber sur le caractere \n. 
La boucle s'arrete alors, ce qui signifie qu'on a « lu » tous les autres caracteres, ils ont 
done ete vides de la memoire. On dit qu'on vide le buffer. 

Pourquoi y a-t-il un point-virgule a la fin du while et pourquoi ne voit-on 
V pas d'accolades? 



En fait, je fais une boucle qui ne contient pas d 'instructions (la seule instruction, e'est 
le getchar entre les parentheses). Les accolades ne sont pas necessaires vu que je n'ai 
rien d'autre a faire qu'un getchar. Je mets done un point-virgule pour remplacer les 
accolades. Ce point-virgule signifie « ne rien faire a chaque passage dans la boucle ». 
C'est un peu particulier je le reconnais, mais e'est une technique a connaitre, technique 
qu'utilisent les programmeurs pour faire des boucles tres courtes et tres simples. 

Dites-vous que le while aurait aussi pu etre ecrit comme ceci : 

while (getcharO != '\n') 
{ 



II n'y a rien entre accolades, c'est volontaire, vu qu'on n'a rien d'autre a faire. Ma 
technique consistant a placer juste un point-virgule est simplement plus courte que 
celle des accolades. 
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Enfin, la fonction lireCaractere retourne le premier caractere qu'elle a lu : la variable 
caractere. 

En resume, pour recuperer une lettre dans votre code, vous n'utiliserez pas : 

I scanf C'/.c" , ftmaLettre) ; 

. . . vous utiliserez a la place notre super-fonction : 

I maLettre = lireCaractere () ; 

Dictionnaire de mots 

Dans un premier temps pour vos tests, je vais vous demander de fixer le mot secret 
directement dans votre code. Vous ecrirez done par exemple : 

| char motSecret[] = "MARRON"; 

Alors oui, bien sur, le mot secret sera toujours le meme si on laisse ga comme ga, 
ce qui n'est pas tres rigolo. Je vous demande de faire comme ga dans un premier 
temps pour ne pas melanger les problemes. En effet, une fois que votre jeu de Pendu 
fonctionnera correctement (et seulement a partir de ce moment-la), vous attaquerez la 
seconde phase : la creation du dictionnaire de mots. 




J Qu'est-ce que e'est, le « dictionnaire de mots » ? 



O 



C'est un fichier qui contiendra de nombreux mots pour votre jeu de Pendu. II doit y 
avoir un mot par ligne. Exemple : 

MAISON 

BLEU 

AVION 

XYLOPHONE 

ABEILLE 

IMMEUBLE 

GOURDIN 

NEIGE 

ZERO 



A chaque nouvelle partie, votre programme devra ouvrir ce fichier et prendre un des 
mots au hasard dans la liste. Grace a cette technique, vous aurez un fichier a part que 
vous pourrez editer tant que vous voudrez pour ajouter des mots secrets possibles pour 
le Pendu. 
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Vous aurez remarque que depuis le debut je fais expres d'ecrire tous les mots 
du jeu en majuscules. En effet, dans le Pendu on ne fait pas la distinction 
entre les majuscules et les minuscules, le mieux est done de se dire des le 
debut : « tous mes mots seront en majuscules ». A vous de prevenir le 
joueur, dans le mode d'emploi du jeu par exemple, qu'il est cense entrer des 
lettres majuscules et non des minuscules. 
Par ailleurs, on fait expres d'ignorer les accents pour simplifier le jeu 2 . Vous 
devrez done ecrire vos mots dans le dictionnaire entierement en majuscules 
et sans accents. 

Le probleme qui se posera rapidement a vous sera de savoir combien il y a de mots 
dans le dictionnaire. En effet, si vous voulez choisir un mot au hasard, il faudra tirer 
au sort un nombre entre et X, et vous ne savez pas a priori combien de mots contient 
votre fichier. 

Pour resoudre le probleme, il y a deux solutions. Vous pouvez indiquer sur la premiere 
ligne du fichier le nombre de mots qu'il contient : 



3 

MAISON 

BLEU 

AVION 



Cependant cette technique est ennuyeuse, car il faudra recompter manuellement le 
nombre de mots a chaque fois que vous en ajouterez un 3 . Aussi je vous propose plutot 
de compter automatiquement le nombre de mots en lisant une premiere fois le fichier 
avec votre programme. Pour savoir combien il y a de mots, e'est simple : vous comptez 
le nombre de \n (retours a la ligne) dans le fichier. 

Une fois que vous aurez lu le fichier une premiere fois pour compter les \n, vous ferez 
un rewind pour revenir au debut. Vous n'aurez alors plus qu'a tirer un nombre au sort 
parmi le nombre de mots que vous avez comptes, puis a vous rendre au mot que vous 
avez choisi et a le stocker dans une chaine en memoire. 

Je vous laisse un peu reflechir a tout cela, je ne vais pas trop vous aider quand meme, 
sinon ca ne serait plus un TP ! Sachez que vous avez acquis toutes les connaissances qu'il 
faut dans les chapitres precedents, vous etes done parfaitement capables de realiser ce 
jeu. Qa, va prendre plus ou moins de temps et e'est moins facile qu'il n'y parait, mais en 
vous organisant correctement (et en creant sufRsamment de fonctions), vous y arriverez. 

Bon courage, et surtout : per-se-ve-rez ! 



2. Si on doit commencer a tester le e, le e, le e, le e. . . on n'a pas fini ! 

3. Ou ajouter 1 a ce nombre si vous etes malins plutot que de tout recompter, mais ga reste quand 
meme une solution un peu bancale. 
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La solution (1 : le code du jeu) 

Si vous lisez ces lignes, c'est soit que vous avez termine le programme, soit que vous 
n'arrivez pas a le terminer. 

J'ai personnellement mis plus de temps que je ne le pensais pour realiser ce petit jeu 
apparemment tout bete. C'est souvent comme <ja : on se dit « bah c'est facile » alors 
qu'en fait, il y a plusieurs cas a gerer. 

Je persiste toutefois a dire que vous etes tous capables de le faire. II vous faudra plus 
ou moins de temps (quelques minutes, quelques heures, quelques jours?), mais <ja n'a 
jamais ete une course. Je prefere que vous y passiez beaucoup de temps et que vous y 
arriviez, plutot que vous n'essayiez que 5 minutes et que vous regardiez la solution. 

N'allez pas croire que j'ai ecrit le programme d'une traite. Moi aussi, comme vous, j'y 
suis alle pas a pas. J'ai commence par faire quelque chose de tres simple, puis petit 
a petit j'ai ameliore le code pour arriver au resultat final. J'ai fait plusieurs erreurs 
en codant : j'ai oublie a un moment d'initialiser une variable correctement, j'ai oublie 
d'ecrire le prototype d'une fonction ou encore de supprimer une variable qui ne servait 
plus dans mon code. J'ai meme - je l'avoue - oublie un bete point-virgule a un moment 
a la fin d'une instruction. 

Tout ga pour dire quoi ? Que je ne suis pas infaillible et que je vis a peu pres les memes 
frustrations que vous 4 . 

Je vais vous presenter la solution en deux temps. 

1. D'abord je vais vous montrer comment j'ai fait le code du jeu lui-meme, en fixant 
le mot cache directement dans le code. J'ai choisi le mot MARRON car il me 
permet de tester si je gere bien les lettres en double, comme le R ici. 

2. Ensuite, je vous montrerai comment dans un second temps j'ai ajoute la gestion 
du dictionnaire de mots pour tirer au sort un mot secret pour le joueur. 

Bien sur, je pourrais vous montrer tout le code d'un coup mais. . . <ja ferait beaucoup a 
la fois, et nombre d'entre vous n'auraient pas le courage de se pencher sur le code. 

Je vais essayer de vous expliquer pas a pas mon raisonnement. Retenez que ce qui 
compte, ce n'est pas le resultat, mais la fagon dont on reflechit. 



Analyse de la fonction main 

Comme tout le monde le sait, tout commence par un main. On n'oublie pas d'inclure 
les bibliotheques stdio, stdlib et ctype (pour la fonction toupperO) dont on aura 
besoin : 

#include <stdio.h> 
#include <stdlib.h> 



4. « ESPECE DE PROGRAMME DE ***** TU VAS TE METTRE A MARCHER, OUI OU 
NON ! ? ». 
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#include <ctype.h> 

int main(int argc, char* argv[]) 
{ 

return ; 
} 

Ok, jusque-la tout le monde devrait suivre. Notre main va gerer la plupart du jeu et 
faire appel a quelques-unes de nos fonctions quand il en aura besom. 

Commengons par declarer les variables necessaires 5 : 

#include <stdio.h> 
#include <stdlib.h> 
#include <ctype.h> 

int main (int argc, char* argv[]) 
{ 

char lettre = 0; // Stocke la lettre proposee par l'utilisateur (retour du 
M> s canf ) 

char motSecret[] = "MARRON" ; // C'est le mot a trouver 

int lettre Trouvee [6] = {0}; // Tableau de booleens. Chaque case correspond 
<— ¥ a une lettre du mot secret. = lettre non trouvee, 1 = lettre trouvee 

int coupsRestants = 10; // Compteur de coups restants (0 = mort) 

int i = 0; // Une petite variable pour parcourir les tableaux 

return ; 



J'ai volontairement ecrit une declaration de variable par ligne ainsi que plusieurs com- 
mentaires pour que vous compreniez l'interet de chaque variable. En pratique, vous 
n'aurez pas forcement besoin de mettre tous ces commentaires et vous pourrez grouper 
plusieurs declarations de variables sur la meme ligne. 

Je pense que la plupart de ces variables semblent logiques : la variable lettre stocke la 
lettre que l'utilisateur tape a chaque fois, motSecret le mot a trouver, coupsRestants 
le nombre de coups, etc. La variable i est une petite variable que j 'utilise pour parcourir 
mes tableaux avec des for. Elle n'est done pas extremement importante mais necessaire 
si on veut faire nos boucles. 

Enfin, la variable a laquelle il fallait penser, celle qui fait la difference, c'est mon tableau 
de booleens lettreTrouvee. Vous remarquerez que je lui ai donne pour taille le nombre 
de lettres du mot secret (6). Ce n'est pas un hasard : chaque case de ce tableau de 
booleens represente une lettre du mot secret. Ainsi, la premiere case represente la 
premiere lettre, la seconde la seconde lettre, etc. Les cases du tableau sont au depart 
initialisees a 0, ce qui signifie « Lettre non trouvee ». Au fur et a mesure de l'avancement 



5. Rassurez-vous, je n'ai pas pense de suite a toutes ces variables, il y en avait un peu moins la 
premiere fois que j'ai ecrit le code ! 
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du jeu, ce tableau sera modifie. Pour chaque lettre du mot secret trouvee, la case 
correspondante du tableau lettreTrouvee sera mise a 1. 

Par exemple, si a un moment du jeu j'ai l'affichage M*RR*N, c'est que mon tableau 
d'int a les valeurs 101101 (1 pour chaque lettre qui a ete trouvee). II est ainsi facile de 
savoir quand on a gagne : il suffit de verifier si le tableau de booleens ne contient que 
des 1. En revanche, on a perdu si le compteur coupsRestants tombe a 0. 

Passons a la suite : 

I printf ("Bienvenue dans le Pendu !\n\n"); 

C'est un message de bienvenue, il n'y a rien de bien palpitant. En revanche, la boucle 
principale du jeu est plus interessante : 

while (coupsRestants > kk ! gagne (lettreTrouvee) ) 
{ 

Le jeu continue tant qu'il reste des coups (coupsRestants > 0) et tant qu'on n'a pas 
gagne. Si on n'a plus de coups a jouer, c'est qu'on a perdu. Si on a gagne, c'est. . . 
qu'on a gagne. Dans les deux cas, il faut arreter le jeu, done arrgter la boucle du jeu 
qui redemande a chaque fois une nouvelle lettre. 

gagne est une fonction qui analyse le tableau lettreTrouvee. Elle renvoie « vrai » (1) 
si le joueur a gagne (le tableau lettreTrouvee ne contient que des 1), « faux » (0) si 
le joueur n'a pas encore gagne. Je ne vous explique pas ici le fonctionnement de cette 
fonction en detail, on verra cela plus tard. Pour le moment, vous avez juste besoin de 
savoir ce que fait la fonction. 

La suite : 

printf ("\n\nll vous reste */,d coups a jouer", coupsRestants); 
printf ("\nQuel est le mot secret ? "); 

/* On affiche le mot secret en masquant les lettres non trouvees 
Exemple : *A**0N */ 
for (i = ; i < 6 ; i++) 
{ 

if (lettreTrouvee [i] ) // Si on a trouve la lettre n° i 

printf C"/.c", motSecret [i] ) ; // On l'affiche 
else 

printf ("*"); // Sinon, on affiche une etoile pour les lettres 
=-> non trouvees 



On affiche a chaque coup le nombre de coups restants ainsi que le mot secret (masque 
par des * pour les lettres non trouvees). L'affichage du mot secret masque par des * se 
fait grace a une boucle for. On analyse chaque lettre pour savoir si elle a ete trouvee 
(if lettreTrouvee [i]). Si c'est le cas, on affiche la lettre. Sinon, on affiche une * de 
remplacement pour masquer la lettre. 
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Maintenant qu'on a affiche ce qu'il fallait, on va demander au joueur de saisir une 
lettre : 

printf ("\nProposez une lettre : ") ; 
lettre = lireCaractereO ; 

Je fais appel a notre fonction lireCaractereO. Celle-ci lit le premier caractere tape, 
le met en majuscule et vide le buffer, c'est-a-dire qu'elle vide les autres caracteres qui 
auraient pu persister dans la memoire. 

// Si ce n' etait PAS la bonne lettre 

if ( ! rechercheLettre (lettre, motSecret, lettreTrouvee) ) 

{ 

coupsRestants--; // On enleve un coup au joueur 

} 
} 

On verifie si la lettre entree se trouve dans motSecret. On fait appel pour cela a 
une fonction maison appelee rechercheLettre. Nous verrons peu apres le code de 
cette fonction. Pour le moment, tout ce que vous avez besoin de savoir, c'est que cette 
fonction renvoie « vrai » si la lettre se trouve dans le mot, « faux » si elle ne s'y trouve 
pas. 

Mon if, vous l'aurez remarque, commence par un point d'exclamation ! qui signifie 
« non ». La condition se lit done « Si la lettre n'a pas ete trouvee ». Que fait-on si la 
lettre n'a pas ete trouvee? On diminue le nombre de coups restants. 

Notez que la fonction rechercheLettre met aussi a jour le tableau de boo- 
leens lettreTrouvee. Elle met des 1 dans les cases des lettres qui ont ete 
trouvees. 




a 



La boucle principale du jeu s'arrete la. On recommence done au debut de la boucle et 
on verifie s'il reste des coups a jouer et si on n'a pas deja gagne. 

Lorsqu'on sort de la boucle principale du jeu, il reste a afficher si on a gagne ou non 
avant que le programme ne s'arrete : 

if (gagne (lettreTrouvee) ) 

printf ("\n\nGagne ! Le mot secret etait bien : '/,s", motSecret); 
else 

printf ("\n\nPerdu ! Le mot secret etait : '/,s", motSecret); 

return ; 
} 

On fait appel a la fonction gagne pour verifier si on a gagne. Si c'est le cas, alors on 
affiche le message « Gagne ! » ; sinon, c'est qu'on n'avait plus de coups a jouer, on a 
ete pendu. 
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Analyse de la fonction gagne 

Voyons maintenant le code de la fonction gagne : 

int gagne(int lettreTrouvee[] ) 
{ 

int i = ; 

int j oueurGagne = 1 ; 

for (i = ; i < 6 ; i++) 
{ 

if (lettreTrouvee[i] == 0) 
j oueurGagne = 0; 
} 

return j oueurGagne; 



Cette fonction prend le tableau de booleens lettreTrouvee pour parametre. Elle ren- 
voie un booleen : « vrai » si on a gagne, « faux » si on a perdu. 

Le code de cette fonction est plutot simple, vous devriez tous le comprendre. On par- 
court lettreTrouvee et on verifie si UNE des cases vaut « faux » (0). Si une des lettres 
n'a pas encore ete trouvee, c'est qu'on a perdu : on met alors le booleen j oueurGagne 
a « faux » (0). Sinon, si toutes les lettres ont ete trouvees, le booleen vaut « vrai » (1) 
et la fonction renverra done « vrai ». 



Analyse de la fonction rechercheLettre 

La fonction rechercheLettre a deux missions : 

- renvoyer un booleen indiquant si la lettre se trouvait bien dans le mot secret ; 

- mettre a jour (a 1) les cases du tableau lettreTrouvee correspondant aux positions 
de la lettre qui a ete trouvee. 

int rechercheLettre (char lettre, char motSecretG, int lettreTrouvee [] ) 
{ 

int i = ; 

int bonneLettre = 0; 

// On parcourt motSecret pour verifier si la lettre proposee y est 

for (i = ; motSecret [i] != '\0' ; i++) 

{ 

if (lettre == motSecret [i] ) // Si la lettre y est 
{ 

bonneLettre =1; //On memorise que e'etait une bonne lettre 
lettreTrouvee [i] =1; //On met a 1 la case du tableau de booleens 
<—} correspondant a la lettre actuelle 

} 
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} 

return bonneLettre; 



On parcourt done la chaine motSecret caractere par caractere. A chaque fois, on verifie 
si la lettre que le joueur a proposee est une lettre du mot. Si la lettre correspond, alors 
on fait deux choses : 

- on change la valeur du booleen bonneLettre a 1, pour que la fonction retourne 1 
car la lettre se trouvait effectivement dans motSecret ; 

- on met a jour le tableau lettreTrouvee a la position actuelle pour indiquer que 
cette lettre a ete trouvee. 

L'avantage de cette technique, e'est qu'ainsi on parcourt tout le tableau (on ne s'arrete 
pas a la premiere lettre trouvee). Cela nous permet de bien mettre a jour le tableau 
lettreTrouvee, au cas ou une lettre serait presente en plusieurs exemplaires dans le 
mot secret, comme e'est le cas pour les deux R de MARRON. 



La solution (2 : la gestion du dictionnaire) 

Nous avons fait le tour des fonctionnalites de base de notre programme. II contient tout 
ce qu'il faut pour gerer une partie, mais il ne sait pas selectionner un mot au hasard 
dans un dictionnaire de mots. Vous pouvez voir a quoi ressemble mon code source au 
complet a ce stade de son ecriture 6 sur le web. Je ne l'ai pas place ici car il prend deja 
plusieurs pages et ferait doublon avec le code source final complet que vous verrez un 
peu plus bas. 



Code web : 300532 



Avant d'aller plus loin, la premiere chose a faire maintenant est de creer ce fameux 
dictionnaire de mots. Meme s'il est court ce n'est pas grave, il conviendra pour les 
tests. 

Je vais done creer un fichier dico.txt dans le meme repertoire que mon projet. 

Pour le moment, j'y mets les mots suivants : 

MAISON 

BLEU 

AVION 

XYLOPHONE 

ABEILLE 

IMMEUBLE 

GOURDIN 

NEIGE 

ZERO 



6. Done sans la gestion du dictionnaire. 
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Une fois que j'aurai termine de coder le programme, je reviendrai bien sur sur ce diction- 
naire et j'y ajouterai evidemment des tooonnes de mots tordus comme XYLOPHONE, 
ou a rallonge comme ANTICONSTITUTIONNELLEMENT. Mais pour le moment, 
retournons a nos instructions. 



Preparation des nouveaux fichiers 

La lecture du « dico » va demander pas mal de lignes de code 7 . Je prends done les 
devants en ajoutant un nouveau fichier a mon projet : dico.c (qui sera charge de la 
lecture du dico). Dans la foulee, je cree le dico.h qui contiendra les prototypes des 
fonctions contenues dans dico.c. 

Dans dico.c, je commence par inclure les bibliotheques dont j'aurai besoin ainsi que 
mon dico.h. A priori, comme souvent, j'aurai besoin de stdio et stdlib ici. En plus 
de cela, je vais etre amene a piocher un nombre au hasard dans le dico, je vais done 
inclure time.h comme on l'avait fait pour notre premier projet « Plus ou Moins ». Je 
vais aussi avoir besoin de string. h pour faire un strlen vers la fin de la fonction : 

#include <stdio.h> 
#include <stdlib.h> 
#include <time.h> 
#include <string.h> 

#include "dico.h" 



La fonction piocherMot 

Cette fonction va prendre un parametre : un pointeur sur la zone en memoire ou elle 
pourra ecrire le mot. Ce pointeur sera fourni par le main(). La fonction renverra un 
int qui sera un booleen : 1 = tout s'est bien passe, = il y a eu une erreur. 

Voici le debut de la fonction : 

int piocherMot (char *motPioche) 
{ 

FILE* dico = NULL; // Le pointeur de fichier qui va contenir notre fichier 

int nombreMots = 0, numMotChoisi =0, i = 0; 

int caractereLu = ; 

Je definis quelques variables qui me seront indispensables. Comme pour lc main(), jc 
n'ai pas pense a mettre toutes ces variables des le debut, il y en a certaines que j'ai 
ajoutees par la suite lorsque je me suis rendu compte que j'en avais besoin. 

Les noms des variables parlent d'eux-memes. On a notre pointeur sur fichier dico 
dont on va se servir pour lire le fichier dico.txt, des variables temporaires qui vont 
stocker les caracteres, etc. Notez que j 'utilise ici un int pour stocker un caractere 



7. Du moins, j'en ai le pressentiment. 
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(caractereLu) car la fonction fgetc que je vais utiliser renvoie un int. II est done 
preferable de stocker le resultat dans un int. 

Passons a la suite : 

dico = fopenCdico.txt", "r") ; // On ouvre le dictionnaire en lecture seule 

// On verifie si on a reussi a ouvrir le dictionnaire 

if (dico == NULL) // Si on n'a PAS reussi a ouvrir le fichier 

{ 

printf ("\nImpossible de charger le dictionnaire de mots"); 
return 0; // On retourne pour indiquer que la fonction a echoue 
// A la lecture du return, la fonction s'arrete immediatement . 

} 

Je n'ai pas grand-chose a ajouter ici. J'ouvre le fichier dico.txt en lecture seule ("r") 
et je verifie si j'ai reussi en testant si dico vaut NULL ou non. Si dico vaut NULL, le 
fichier n'a pas pu etre ouvert (fichier introuvable ou utilise par un autre programme). 
Dans ce cas, j'afHche une erreur et je fais un return 0. 

Pourquoi un return la? En fait, l'instruction return commande l'arret de la fonction. 
Si le dico n'a pas pu etre ouvert, la fonction s'arrete la et l'ordinateur n'ira pas lire 
plus loin. On retourne pour indiquer au main que la fonction a echoue. 

Dans la suite de la fonction, on suppose done que le fichier a bien ete ouvert. 

// On compte le nombre de mots dans le fichier (il suffit de compter les 

•-> entrees \n 

do 

{ 

caractereLu = fgetc (dico) ; 

if (caractereLu == '\n') 
nombreMots++; 
} while (caractereLu != EOF); 

La, on parcourt tout le fichier a coups de fgetc (caractere par caractere). On compte 
le nombre de \n (entrees) qu'on detecte. A chaque fois qu'on tombe sur un \n, on incre- 
mente la variable nombreMots. Grace a ce bout de code, on obtient dans nombreMots 
le nombre de mots dans le fichier 8 . 

I numMotChoisi = nombreAleatoire (nombreMots) ; // On pioche un mot au hasard 

Ici, je fais appel a une fonction de mon cru qui va generer un nombre aleatoire entre 
1 et nombreMots (le parametre qu'on envoie a la fonction). C'est une fonction toute 
simple que j'ai placee aussi dans dico . c (je vous la detaillerai tout a l'heure). Bref, elle 
renvoie un nombre (correspondant a un numero de ligne du fichier) au hasard qu'on 
stocke dans numMotChoisi. 



8. Rappelez-vous que le fichier contient un mot par ligne. 
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II On recommence a lire le fichier depuis le debut. On s'arrete lorsqu'on est 

<->• arrive au bon mot 

rewind(dico) ; 

while (numMotChoisi > 0) 

{ 

caractereLu = fgetc(dico); 

if (caractereLu == '\n') 
numMotChoisi--; 
} 

Maintenant qu'on a le numero du mot qu'on veut piocher, on repart au debut grace 
a un appel a rewind(). On parcourt la encore le fichier caractere par caractere en 
comptant les \n. Cette fois, on decremente la variable numMotChoisi. Si par exemple 
on a choisi le mot numero 5, a chaque entree la variable va etre decrementee de 1. Elle 
va done valoir 5, puis 4, 3, 2, 1. . . et 0. Lorsque la variable vaut 0, on sort du while, 
la condition numMotChoisi > n'etant plus remplie. 

Ce bout de code, que vous devez imperativement comprendre, vous montre done com- 
ment on parcourt un fichier pour se placer a la position voulue. Ce n'est pas bien 
complique, mais ce n'est pas non plus « evident ». Assurez-vous done de bien com- 
prendre ce que je fais la. 

Maintenant, on devrait avoir un curseur positionne juste devant le mot secret qu'on 
a choisi de piocher. On va le stocker dans motPioche (le parametre que la fonction 
regoit) grace a un simple f gets qui va lire le mot : 

/* Le curseur du fichier est positionne au bon endroit . 
On n'a plus qu'a faire un fgets qui lira la ligne */ 
f gets (motPioche, 100, dico) ; 

// On vire le \n a la fin 

motPioche [strlen (motPioche) - 1] = '\0'; 

On demande au fgets de ne pas lire plus de 100 caracteres (e'est la taille du tableau 
motPioche, qu'on a defini dans le main). N'oubliez pas que fgets lit toute une ligne, 
y compris le \n. Comme on ne veut pas garder ce \n dans le mot final, on le supprime 
en le remplagant par un \0. Cela aura pour effet de couper la chaine juste avant le \n. 

Et. . . voila qui est fait ! On a ecrit le mot secret dans la memoire a l'adresse de 
motPioche. 

On n'a plus qu'a fermer le fichier, a retourner 1 pour que la fonction s'arrete et pour 
dire que tout s'est bien passe : 

f close(dico) ; 

return 1; // Tout s'est bien passe, on retourne 1 



Pas besoin de plus pour la fonction piocherMot ! 
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La fonction nombreAleatoire 

C'est la fonction dont j'avais promis de vous parler tout a l'heure. On tire un nombre 
au hasard et on le renvoie : 

int nombreAleatoire (int nombreMax) 
{ 

srand (time (NULL)) ; 

return (rand() '/, nombreMax) ; 
} 

La premiere ligne initialise le generateur de nombres aleatoires, comme on a appris a 
le faire dans le premier TP « Plus ou Moins ». La seconde ligne prend un nombre au 
hasard entre et nombreMax et le renvoie 9 . 



Le fichier dico .h 

II s'agit juste des prototypes des fonctions. Vous remarquerez qu'il y a la « protection » 
#ifndef que je vous avais demande d'inclure dans tous vos fichiers .h (revoyez le 
chapitre sur le preprocesseur au besoin). 

#ifndef DEF_DIC0 
#define DEF_DIC0 

int piocherMot (char *motPioche) ; 
int nombreAleatoire (int nombreMax); 

#endif 
> ( Code web : 544019 ) 

Le fichier dico .c 

Voici le fichier dico . c en entier : 

/* 

Jeu du Pendu 

dico .c 



Ces fonctions piochent au hasard un mot dans un fichier dictionnaire 

pour le jeu du Pendu 

*/ 



9. Notez que j'ai fait tout ga en une ligne, c'est tout a fait possible, bien que peut-etre parfois moins 
lisible. 
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#include <stdio.h> 
#include <stdlib.h> 
#include <time.h> 
#include <string.h> 

#include "dico.h" 

int piocherMot (char *motPioche) 
{ 

FILE* dico = NULL; // Le pointeur de fichier qui va contenir notre fichier 

int nombreMots = 0, numMotChoisi =0, i = 0; 

int caractereLu = ; 

dico = fopenCdico.txt", "r") ; // On ouvre le dictionnaire en lecture seule 

// On verifie si on a reussi a ouvrir le dictionnaire 

if (dico == NULL) // Si on n'a PAS reussi a ouvrir le fichier 

{ 

printf ("\nImpossible de charger le dictionnaire de mots"); 
return 0; // On retourne pour indiquer que la fonction a echoue 
// A la lecture du return, la fonction s'arrete immediatement . 

} 

// On compte le nombre de mots dans le fichier (il suffit de compter les 

// entrees \n 

do 

{ 

caractereLu = fgetc(dico) ; 

if (caractereLu == '\n') 
nombreMots++; 
} while (caractereLu != EOF); 

numMotChoisi = nombreAleatoire (nombreMots) ; // On pioche un mot au hasard 

// On recommence a lire le fichier depuis le debut. On s'arrete lorsqu'on 
c — ¥ est arrive au bon mot 
rewind(dico) ; 
while (numMotChoisi > 0) 
{ 

caractereLu = fgetc(dico) ; 
if (caractereLu == '\n') 
numMotChoisi-- ; 
} 

/* Le curseur du fichier est positionne au bon endroit. 
On n'a plus qu'a faire un fgets qui lira la ligne */ 
f gets(motPioche, 100, dico); 

// On vire le \n a la fin 

motPioche [strlen(motPioche) - 1] = '\0'; 
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f close(dico) ; 

return 1; // Tout s'est bien passe, on retourne 1 



int nombreAleatoire(int nombreMax) 
{ 

srand (time (NULL)) ; 

return (rand() '/, nombreMax) ; 
} 



t> ( Code web : 366334 ) 

II va falloir modifier le main ! 

Maintenant que le fichier dico.c est pret, on retourne dans le main() pour l'adapter 
un petit peu aux quelques changements qu'on vient de faire. 

Deja, on commence par inclure dico.h si on veut pouvoir faire appel aux fonctions de 
dico.c. De plus, on va aussi inclure string. h car on va devoir faire un strlen : 

#include <string.h> 
#include "dico.h" 

Pour commencer, les definitions de variables vont un peu changer. Deja, on n'initialise 
plus la chaine motSecret, on cree juste un grand tableau de char (100 cases). 

Quant au tableau lettreTrouvee. . . sa taille dependra de la longueur du mot secret 
qu'on aura pioche. Comme on ne connait pas encore cette taille, on cree un simple 
pointeur. Tout a l'heure, on fera un malloc et pointer ce pointeur vers la zone memoire 
qu'on aura allouee. Ceci est un exemple parfait de l'absolue necessite de l'allocation 
dynamique : on ne connait pas la taille du tableau avant la compilation, on est done 
oblige de creer un pointeur et de faire un malloc. 

Je ne dois pas oublier de liberer la memoire ensuite quand je n'en ai plus besoin, d'ou 
la presence d'un free() a la fin du main. 

On va aussi avoir besoin d'une variable tailleMot qui va stocker. . . la taille du mot. En 
effet, si vous regardez le main() tel qu'il etait dans la premiere partie, on supposait que 
le mot faisait 6 caracteres partout (et e'etait vrai car MARRON comporte 6 lettres). 
Mais maintenant que le mot peut changer de taille, il va falloir etre capable de s'adapter 
a tous les mots ! 

Void done les definitions de variables du main en version finale : 

int main (int argc, char* argv[]) 
{ 

char lettre = 0; // Stocke la lettre proposee par l'utilisateur (retour du 
M> s canf ) 
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char motSecret [100] = {0}; // Ce sera le mot a trouver 

int *lettreTrouvee = NULL; // Un tableau de booleens . Chaque case correspond 
7 a une lettre du mot secret. = lettre non trouvee, 1 = lettre trouvee 
int coupsRestants = 10; // Compteur de coups restants (0 = mort) 
int i = 0; // Une petite variable pour parcourir les tableaux 
int tailleMot = 0; 

C'est principalement le debut du main qui va changer, done analysons-le de plus pres : 

if (! piocherMot (motSecret) ) 
exit(0) ; 

On fait d'abord appel a piocherMot directement dans le if. piocherMot va placer 
dans motSecret le mot qu'elle aura pioche. 

De plus, piocherMot va renvoyer un booleen pour nous dire si la fonction a reussi ou 
echoue. Le role du if est d'analyser ce booleen. Si <ja n'a PAS marche (le ! permet 
d'exprimer la negation), alors on arrete tout (exit(0)). 

I tailleMot = strlen (motSecret) ; 

On stocke la taille du motSecret dans tailleMot comme je vous l'ai dit tout a l'heure. 

lettreTrouvee = malloc (tailleMot * sizeof (int) ) ; // On alloue dynamiquement le 
'—¥ tableau lettreTrouvee (dont on ne connaissait pas la taille au depart) 
if (lettreTrouvee == HULL) 
exit(0) ; 

Maintenant on doit allouer la memoire pour le tableau lettreTrouvee. On lui donne 
la taille du mot (tailleMot). On verifie ensuite si le pointeur n'est pas NULL. Si c'est le 
cas, c'est que l'allocation a echoue. Dans ce cas, on arrete immediatement le programme 
(on fait appel a exitO). 

Si les lignes suivantes sont lues, c'est done que tout s'est bien passe. 

Voila tous les preparatifs qu'il vous fallait faire ici. J'ai du ensuite modifier le reste du 
fichier main.c pour remplacer tous les nombres 6 (l'ancienne longueur de MARRON 
qu'on avait fixee) par la variable tailleMot. Par exemple : 

for (i = ; i < tailleMot ; i++) 
lettreTrouvee [i] = 0; 

Ce code met toutes les cases du tableau lettreTrouvee a 0, en s'arretant lorsqu'on a 
parcouru tailleMot cases. 

J'ai du aussi remanier le prototype de la fonction gagne pour ajouter la variable 
tailleMot. Sans cela, la fonction n'aurait pas su quand arreter sa boucle. 

Voici le fichier main . c final en entier : 
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Jeu du Pendu 



Fonctions principales de gestion du jeu 
*/ 

#include <stdio.h> 
#include <stdlib.h> 
#include <ctype.h> 
#include <string.h> 

#include "dico.h" 

int gagne(int lettreTrouvee [] , long tailleMot) ; 

int rechercheLettre(char lettre, char motSecret [] , int lettreTrouvee []) ; 

char lireCaractereO ; 

int main (int argc, char* argv[]) 
{ 

char lettre = 0; // Stocke la lettre proposee par l'utilisateur (retour du 
•-> s canf ) 

char motSecret [100] = {0}; // Ce sera le mot a trouver 

int * lettreTrouvee = NULL; // Un tableau de booleens. Chaque case correspond 
•-> a une lettre du mot secret. = lettre non trouvee, 1 = lettre trouvee 

long coupsRestants = 10; // Compteur de coups restants (0 = mort) 

long i = 0; // Une petite variable pour parcourir les tableaux 

long tailleMot = 0; 

printf ("Bienvenue dans le Pendu !\n\n"); 

if ( IpiocherMot (motSecret) ) 
exit(0) ; 

tailleMot = strlen (motSecret) ; 

lettreTrouvee = malloc (tailleMot * sizeof (int) ) ; // On alloue dynamiquement 
<— ¥ le tableau lettreTrouvee (dont on ne connaissait pas la taille au depart) 
if (lettreTrouvee == NULL) 
exit(0) ; 

for (i = ; i < tailleMot ; i++) 
lettreTrouvee [i] = 0; 

/* On continue a jouer tant qu'il reste au moins un coup a jouer ou qu'on 

n'a pas gagne */ 
while (coupsRestants > && ! gagne (lettreTrouvee, tailleMot)) 
{ 
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printf ("\n\nll vous reste '/,ld coups a jouer", coupsRestants) ; 
printf ("\nQuel est le mot secret ? "); 

/* On affiche le mot secret en masquant les lettres non trouvees 

Exemple : *A**0N */ 

for (i = ; i < tailleMot ; i++) 

{ 

if (lettreTrouvee [i] ) // Si on a trouve la lettre n° i 

printf ("*/,c" , motSecret [i] ) ; // On l'affiche 
else 

printf ("*"); // Sinon, on affiche une etoile pour les lettres 
<—¥ non trouvees 

} 

printf ("\nProposez une lettre : "); 
lettre = lireCaractereO ; 

// Si ce n'etait PAS la bonne lettre 

if ( IrechercheLettre (lettre, motSecret, lettreTrouvee)) 

{ 

coupsRestants--; // On enleve un coup au joueur 
} 



if (gagne (lettreTrouvee, tailleMot)) 

printf ("\n\nGagne ! Le mot secret etait bien : '/,s", motSecret); 
else 

printf ("\n\nPerdu ! Le mot secret etait : '/,s", motSecret); 

free (lettreTrouvee) ; // On libere la memoire allouee manuellement (par 
<—} malloc) 

return ; 



char lireCaractereO 
{ 

char caractere = 0; 

caractere = getcharO ; // On lit le premier caractere 

caractere = toupper (caractere) ; // On met la lettre en majuscule si elle ne 
<— ¥ l'est pas deja 

// On lit les autres caracteres memorises un a un jusqu'au \n 
while (getcharO != '\n') ; 

return caractere; // On retourne le premier caractere qu'on a lu 
} 

int gagne(int lettreTrouvee [] , long tailleMot) 
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long i = ; 

int j oueurGagne = 1 ; 

for (i = ; i < tailleMot ; i++) 
{ 

if (lettreTrouvee[i] == 0) 
j oueurGagne = ; 
} 

return j oueurGagne ; 



int rechercheLettre(char lettre, char motSecret [] , int lettreTrouvee [] ) 
{ 

long i = ; 

int bonneLettre = 0; 

// On parcourt motSecret pour verifier si la lettre proposee y est 

for (i = ; motSecret [i] != '\0' ; i++) 

{ 

if (lettre == motSecret [i] ) // Si la lettre y est 
{ 

bonneLettre = 1; //On memorise que c'etait une bonne lettre 
lettreTrouvee [i] = 1; //On met a 1 la case du tableau de booleens 
°-> correspondant a la lettre actuelle 

} 
} 



return bonneLettre; 



} 



> [Code web : 105550 ) 

Idees d'amelioration 
Telecharger le projet 

Pour commencer, je vous invite a telecharger le projet complet du Pendu. 

> ( Code web : 587545 ) 

Si vous etes sous Linux ou sous Mac, supprimez le fichier dico.txt et recreez-en un. 
Les fichiers sont enregistres de maniere differente sous Windows : done si vous utilisez 
le mien, vous risquez d'avoir des bugs. N'oubliez pas qu'il faut qu'il y ait une Entree 
apres chaque mot du dictionnaire. Pensez en particulier a mettre une Entree apres le 
dernier mot de la liste. 

Cela va vous permettre de tester par vous-memes le fonctionnement du projet, de 
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proceder a des ameliorations personnelles, etc. Bien entendu, le mieux serait que vous 
ayez deja reussi le Pendu par vous-memes et que vous n'ayez meme pas besoin de voir 
mon projet pour voir comment j'ai fait mais. . . je suis realiste, je sais que ce TP a du 
etre assez delicat pour bon nombre d'entre vous. 

Vous trouverez dans ce .zip les fichiers . c et .h ainsi que le fichier . cbp du projet. 
C'est un projet fait sous Code: :Blocks. Si vous utilisez un autre IDE, pas de panique. 
Vous creez un nouveau projet console et vous y ajoutez manuellement les . c et .h que 
vous trouverez dans le .zip. 

Vous trouverez aussi l'executable ( . exe Windows) ainsi qu'un dictionnaire (dico . txt). 

Ameliorez le Pendu ! 

Mine de rien, le Pendu est deja assez evolue comme ga. On a un jeu qui lit un fichier 
de dictionnaire et qui prend a chaque fois un mot au hasard. 

Voici quand meme quelques idees d'amelioration que je vous invite a implemented 

- Actuellement, on ne vous propose de jouer qu'une fois. II serait bien de pouvoir 
boucler a nouveau a la fin du main pour lancer une nouvelle partie si le joueur 
le desire. 

- Vous pourriez creer un mode deux joueurs dans lequel le premier joueur entre un 
mot que le deuxieme joueur doit deviner. 

- Ce n'est pas utile (done c'est indispensable) : pourquoi ne pas dessiner 10 un bon- 
homme qui se fait pendre a chaque fois que l'on fait une erreur ? 

Prenez bien le temps de comprendre ce TP et ameliorez-le au maximum. II faut que 
vous soyez capables de refaire ce petit jeu de Pendu les yeux fermes ! 

Allez, courage. 



10. A coups de printf bien sur : on est en console, rappelez-vous ! 
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La saisie de texte securisee 



La saisie de texte est un des aspects les plus delicats du langage C. Vous connaissez 
la fonction scanf , que vous avez vue au debut du cours. Vous vous dites : quoi de 
plus simple et de plus naturel? Eh bien figurez-vous que non, en fait, c'est tout sauf 
simple. 

Ceux qui vont utiliser votre programme sont des humains. Tout humain qui se respecte fait 
des erreurs et peut avoir des comportements inattendus. Si vous lui demandez : « Quel 
age avez-vous? », qu'est-ce qui vous garantit qu'il ne va pas vous repondre « Je m'appelle 
Francois je vais bien merci » ? 

Le but de ce chapitre est de vous faire decouvrir les problemes que Ton peut rencontrer en 
utilisant la fonction scanf et de vous montrer une alternative plus sure avec la fonction 
f gets. 




\ 
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Les limites de la fonction scanf 

La fonction scanf (), que je vous ai presentee des le debut du cours de C, est une 
fonction a double tranchant : 

- elle est facile a utiliser quand on debute (c'est pour ca que je vous l'ai presentee). . . 

- . . . mais son fonctionnement interne est complexe et elle peut nieme etre dangereuse 
dans certains cas. 

C'est un peu contradictoire, n'est-ce pas? En fait, scanf a I'air facile a utiliser, mais 
elle ne l'est pas en pratique. Je vais vous montrer ses limites par deux exemples concrets. 

Entrer une chaine de caracteres avec des espaces 

Supposons qu'on demande une chaine de caracteres a l'utilisateur, mais que celui-ci 
insere un espace dans sa chaine : 

#include <stdio.h> 
#include <stdlib.h> 

int main(int argc, char *argv[]) 
{ 

char nom[20] = {0}; 

printf ("Quel est votre nom ? "); 

scanf ("'/,s" , nom); 

printf ("Ah ! Vous vous appelez done */,s ! \n\n" , nom); 

return 0; 



> [Code web : 115729) 

Quel est votre nom ? Jean Dupont 
Ah ! Vous vous appelez done Jean ! 




J Pourquoi le « Dupont » a disparu ? 



O 



Parce que la fonction scanf s'arrete si elle tombe au cours de sa lecture sur un espace, 
une tabulation ou une entree. 

Vous ne pouvez done pas recuperer la chaine si celle-ci comporte un espace. 

En fait, le mot "Dupont" se trouve toujours en memoire, dans ce qu'on 




appelle le buffer. La prochaine fois qu'on appellera scanf, la fonction lira 
toute seule le mot « Dupont » qui etait reste en attente dans la memoire. 
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On peut utiliser la fonction scanf de telle sorte qu'elle lise les espaces, mais c'est assez 
complique. Si vous voulez apprendre a bien vous servir de scanf, on peut trouver des 
cours tres detailles sur le web 1 . 

> ( Code web : 486440 ) 

Entrer une chaine de caracteres trop longue 

II y a un autre probleme, beaucoup plus grave encore : celui du depassement de 
memoir e. 

Dans le code que nous venons de voir, il y a la ligne suivante : 

I char nom[5] = {0}; 

Vous voyez que j'ai alloue 5 cases pour mon tableau de char appele nom. Cela signifie 
qu'il y a la place d'ecrire 4 caracteres, le dernier etant toujours reserve au caractere de 
fin de chaine \0. Revoyez absolument le cours sur les chaines de caracteres (page 169) 
si vous avez oublie tout cela. 

La fig. 19.1 vous presente l'espace qui a ete alloue pour nom. 


















? 


? 


■? 


7 


? 


? 


? 


? 



Espace allouS pour nom Espace non pr^vu pour nom 
(5 cases) 



Figure 19.1 - Allocation de memoire 



Que se passe-t-il si vous ecrivez plus de caracteres qu'il n'y a d'espace prevu pour les 
stocker ? 



Quel est votre nom ? Patrice 

Ah ! Vous vous appelez done Patrice ! 



A priori, il ne s'est rien passe. Et pourtant, ce que vous voyez la est un veritable 
cauchemar de programmeur ! 

On dit qu'on vient de faire un depassement de memoire, aussi appele buffer overflow 
en anglais. 

Comme vous le voyez sur la fig. 19.2, on avait alloue 5 cases pour stocker le nom, mais 
en fait il en fallait 8. Qu'a fait la fonction scanf ? Elle a continue a ecrire a la suite en 
memoire comme si de rien n'etait ! Elle a ecrit dans des zones memoire qui n'etaient 
pas prevues pour cela. 

Les caracteres en trop ont « ecrase » d'autres informations en memoire. C'est ce qu'on 
appelle un buffer overflow (fig. 19.3). 



1. Attention, c'est assez difficile. 
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E space necessaire pour stocker 
« Patrice >* : 8 cases 



nam P a t r 



ce\0 7???7 



Espace allou6 pour nom Espace non prevu pour nom 

(5 cases) 



Figure 19.2 - Depassement dans la memoire 

Buffer overflow ! 

(depassement cfc memoire) 



nom P a t r 



? ? ? ? ? 



Figure 19.3 - Le buffer overflow 




f 



o 



En quoi cela est-il dangereux? 



Sans entrer dans les details, car on pourrait en parler pendant 50 pages sans avoir 
fini 2 , il faut savoir que si le programme ne controle pas ce genre de cas, l'utilisateur 
peut ecrire ce qu'il veut a la suite en memoire. En particulier, il peut inserer du code 
en memoire et faire en sorte qu'il soit execute par le programme. C'est l'attaque par 
buffer overflow, une attaque de pirate celebre mais difficile a realiser. 

Le but de ce chapitre sera de securiser la saisie de nos donnees, en empechant l'utilisa- 
teur de faire deborder et de provoquer un buffer overflow. Bien sur, on pourrait allouer 
un tres grand tableau (10 000 caracteres), mais ga ne changerait rien au probleme : 
une personne qui veut faire depasser de la memoire n'aura qu'a envoyer plus de 10 000 
caracteres et son attaque marchera tout aussi bien. 

Aussi bete que cela puisse paraitre, tous les programmeurs n'ont pas toujours fait 
attention a cela. S'ils avaient fait les choses proprement depuis le debut, une bonne 
partie des failles de securite dont on entend parler encore aujourd'hui ne serait jamais 



apparue 



Recuperer une chaine de caracteres 

II existe plusieurs fonctions standards en C qui permettent de recuperer une chaine de 
texte. Hormis la fonction scanf (trop compliquee pour etre etudiee ici), il existe : 

- gets : une fonction qui lit toute une chaine de caracteres, mais tres dangereuse car 
elle ne permet pas de controler les buffer overflow ! 



2. Si l'attaque par buffer overflow vous interesse, vous pouvez lire Particle « Depassement de tam- 
pon » de Wikipedia (code web : 251507). Attention c'est quand meme assez complique. 
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- fgets : l'equivalent de gets mais en version securisee, permettant de controler le 
nombre de caracteres ecrits en memoire. 

Vous l'aurez compris : bien que ce soit une fonction standard du C, gets est tres 
dangereuse. Tous les programmes qui l'utilisent sont susceptibles d'etre victimes de 
buffer overflow. 

Nous allons done voir comment fonctionne fgets et comment on peut l'utiliser en 
pratique dans nos programmes en remplacement de scanf . 

La fonction fgets 

Le prototype de la fonction fgets, situe dans stdio.h, est le suivant : 

I char *fgets( char *str, int num, FILE *stream ); 

II est important de bien comprendre ce prototype. Les parametres sont les suivants. 

- str : un pointeur vers un tableau alloue en memoire ou la fonction va pouvoir ecrire 
le texte entre par l'utilisateur. 

- num : la taille du tableau str envoye en premier parametre. Notez que si vous avez 
alloue un tableau de 10 char, fgets lira 9 caracteres au maximum (il reserve toujours 
un caractere d'espace pour pouvoir ecrire le \0 de fin de chaine). 

- stream : un pointeur sur le fichier a lire. Dans notre cas, le « fichier a lire » est l'entree 
standard, e'est-a-dire le clavier. Pour demander a lire l'entree standard, on enverra le 
pointeur stdin, qui est automatiquement defini dans les headers de la bibliotheque 
standard du C pour representer le clavier. Toutefois, il est aussi possible d'utiliser 
fgets pour lire des fichiers, comme on a pu le voir dans le chapitre sur les fichiers. 

La fonction fgets retourne le meme pointeur que str si la fonction s'est deroulee sans 
erreur, ou NULL s'il y a eu une erreur. II suffit done de tester si la fonction a renvoye 
NULL pour savoir s'il y a eu une erreur. 

Testons ! 

#include <stdio.h> 
#include <stdlib.h> 

int main (int argc, char *argv[]) 
{ 

char nom[10] ; 

printf("Quel est votre nom ? ") ; 

fgets (nom, 10, stdin); 

printf("Ah ! Vous vous appelez done */,s ! \n\n" , nom); 



return ; 



} 



> ( Code web : 769987 ) 
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Quel est votre nom ? Mateo 

Ah ! Vous vous appelez done Mateo 



Ca fonctionne tres bien, a un detail pres : quand vous pressez « Entree », f gets conserve 
le \n correspondant a l'appui sur la touche « Entree ». Cela se voit dans la console car 
il y a un saut a la ligne apres « Mateo » dans mon exemple. 

On ne peut rien faire pour empecher f gets d'ecrire le caractere \n, la fonction est faite 
comme <ja. En revanche, rien ne nous interdit de creer notre propre fonction de saisie 
qui va appeler fgets et supprimer automatiquement a chaque fois les \n! 

Creer sa propre fonction de saisie utilisant fgets 

II n'est pas tres difficile de creer sa propre petite fonction de saisie qui va faire quelques 
corrections a chaque fois pour nous. 

Nous appellerons cette fonction lire. Elle renverra 1 si tout s'est bien passe, s'il y a 
eu une erreur. 



Eliminer le saut de ligne \n 

La fonction lire va appeler fgets et, si tout s'est bien passe, elle va rechercher le 
caractere \n a l'aide de la fonction strchr que vous devriez deja connaitre. Si un \n 
est trouve, elle le remplace par un \0 (fin de chaine) pour eviter de conserver une 
« Entree ». 

Voici le code, commente pas a pas : 

#include <stdio.h> 

#include <stdlib.h> 

#include <string.h> // Penser a inclure string. h pour strchr () 

int lire (char *chaine, int longueur) 
{ 

char *positionEntree = NULL; 

// On lit le texte saisi au clavier 

if (fgets (chaine, longueur, stdin) != NULL) // Pas d'erreur de saisie ? 

{ 

positionEntree = strchr (chaine, '\n'); // On recherche l'"Entree" 

if (positionEntree != NULL) // Si on a trouve le retour a la ligne 

{ 

^positionEntree = '\0'; // On remplace ce caractere par \0 

} 

return 1; // On renvoie 1 si la fonction s'est deroulee sans erreur 
} 

else 
{ 
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return 0; //On renvoie s'il y a eu une erreur 



D> ( Code web : 519318) 



Vous noterez que je me permets d'appeler la fonction f gets directement dans un if. 
Qa m'evite d'avoir a recuperer la valeur de f gets dans un pointeur juste pour tester 
si celui-ci est NULL ou non. 

A partir du premier if, je sais si fgets s'est bien deroulee ou s'il y a eu un probleme 
(l'utilisateur a rentre plus de caracteres qu'il n'etait autorise). 

Si tout s'est bien passe, je peux alors partir a la recherche du \n avec strchr et 
remplacer cet \n par un \0 (fig. 19.4). 
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Figure 19.4 - Remplacement du saut de ligne 

Ce schema montre que la chaine ecrite par fgets etait « Mateo\n\0 ». Nous avons 
remplace le \n par un \0, ce qui a donne au final : « Mateo\0\0 ». Ce n'est pas grave 
d'avoir deux \0 d'affilee. L'ordinateur s'arrete au premier \0 qu'il rencontre et considere 
que la chaine de caracteres s'arrete la. 

Le resultat ? Eh bien ga marche. 

int main(int argc, char *argv[]) 
{ 

char nom[10] ; 

printf("Quel est votre nom ? ") ; 

lire(nom, 10) ; 

printf("Ah ! Vous vous appelez done */,s ! \n\n" , nom); 

return ; 



Quel est votre nom ? Mateo 

Ah ! Vous vous appelez done Mateo ! 



Vider le buffer 

Nous ne sommes pas encore au bout de nos ennuis. Nous n'avons pas etudie ce qui se 
passait si l'utilisateur tentait de mettre plus de caracteres qu'il n'y avait de place ! 
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Quel est votre nom ? Jean Edouard Albert ler 
Ah ! Vous vous appelez done Jean Edou ! 



La fonction f gets etant securisee, elle s'est arretee de lire au bout du 9 e caractere car 
nous avions alloue un tableau de 10 char (il ne faut pas oublier le caractere de fin de 
chaine \0 qui occupe la 10 e position). 

Le probleme, e'est que le reste de la chaine qui n'a pas pu etre lu, a savoir « ard 
Albert ler », n'a pas disparu ! II est toujours dans le buffer. Le buffer est une sorte de 
zone memoire qui regoit directement l'entree clavier et qui sert d'intermediaire entre 
le clavier et votre tableau de stockage. En C, on dispose d'un pointeur vers le buffer, 
e'est ce fameux stdin dont je vous parlais un peu plus tot. 

Je crois qu'un petit schema ne sera pas de refus pour mettre les idees au clair (fig. 
19.5). 



stdin 




M L'utilisateur tape sa 
chaTne au clavier 



OS (Windows, Linux...) 



chaine 



M 


a 


t 
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\n 
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2/ Celle-ci est transferee 
par I'OS au buffer stdin 



3/ La fonction fgets transmet 
la chaTne dans votre zone 
memoire et supprime ce 

quelle a lu du buffer 



Figure 19.5 - Lecture du buffer du clavier 

Lorsque l'utilisateur tape du texte au clavier, le systeme d'exploitation (Windows, par 
exemple) copie directement le texte tape dans le buffer stdin. Ce buffer est la pour 
recevoir temporairement l'entree du clavier. 

Le role de la fonction fgets est justement d'extraire du buffer les caracteres qui s'y 
trouvent et de les copier dans la zone memoire que vous lui indiquez (votre tableau 
chaine). Apres avoir effectue son travail de copie, fgets enleve du buffer tout ce qu'elle 
a pu copier. 

Si tout s'est bien passe, fgets a done pu copier tout le buffer dans votre chaine, et ainsi 
le buffer se retrouve vide a la fin de l'execution de la fonction. Mais si l'utilisateur entre 
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beaucoup de caracteres, et que la fonction f gets ne peut copier qu'une partie d'entre 
eux (parce que vous avez alloue un tableau de 10 char seulement), seuls les caracteres 
lus seront supprimes du buffer. Tous ceux qui n'auront pas ete lus y resteront ! 

Testons avec une longue chaine : 



int main(int argc, char *argv[]) 
{ 

char nom [10] ; 

printf("Quel est votre nom ? ") ; 

lire(nom, 10) ; 

printf("Ah ! Vous vous appelez done */,s ! \n\n" , nom); 

return ; 



Quel est votre nom ? Jean Edouard Albert ler 
Ah ! Vous vous appelez done Jean Edou ! 



La fonction fgets n'a pu copier que les 9 premiers caracteres comme prevu. Le pro- 
bleme, e'est que les autres se trouvent toujours dans le buffer (fig. 19.6) ! 



stdin 




Ce que la fonction fgets 
n 'a pas pu lire, elle le 
laisse dans le buffer 1 



chaine 



J 


e 


a 


n 




E 


d 





j 


\0 


7 


? 





Figure 19.6 - Lecture du buffer du clavier avec debordement 

Cela signifie que si vous faites un autre fgets ensuite, celui-ci va aller recuperer ce qui 
etait reste en memoire dans le buffer ! 

Testons ce code : 
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int main(int argc, char *argv[]) 
{ 

char nom[10] ; 

printf("Quel est votre nom ? "); 

lire(nom, 10) ; 

printf("Ah ! Vous vous appelez done */,s ! \n\n" , nom); 

lire (nom, 10) ; 

printf("Ah ! Vous vous appelez done */,s ! \n\n" , nom); 

return 0; 



Nous appelons deux fois la fonction lire. Pourtant, vous allez voir qu'on ne vous laisse 
pas taper deux fois votre nom : en effet, la fonction f gets ne demande pas a l'utilisateur 
de taper du texte la seconde fois car elle trouve du texte a recuperer dans le buffer ! 



Quel 


est votre 


nom 


? Jean Edouard Albert 


ler 


Ah ! 


Vous 


vous 


appelez 


done 


Jean Edou ! 




Ah ! 


Vous 


vous 


appelez 


done 


ard 


Alber ! 





Si l'utilisateur tape trop de caracteres, la fonction f gets nous protege contre le debor- 
dement de memoire, mais il reste toujours des traces du texte en trop dans le buffer. 
II faut vider le buffer. 

On va done ameliorer notre petite fonction lire et appeler — si besoin est — une 
sous-fonction viderBuf i er pour faire en sorte que le buffer soit vide si on a rentre trop 
de caracteres : 

void viderBuf fer() 
{ 

int c = ; 

while (c != >\n> && c != EOF) 

{ 

c = get char () ; 

} 
} 

int lire (char *chaine, int longueur) 
{ 

char *positionEntree = NULL; 

if (fgets (chaine, longueur, stdin) != NULL) 
{ 

positionEntree = strchr (chaine, '\n'); 

if (positionEntree != NULL) 

{ 

^positionEntree = '\0'; 

} 
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else 

{ 

viderBuff er() ; 

} 

return 1 ; 
} 

else 
{ 

viderBuf f er () ; 

return ; 
} 
} 

> [ Code web : 468967 ) 

La fonction lire appelle viderBuf fer dans deux cas : 

- si la chaine etait trop longue (on le sait parce qu'on n'a pas trouve de caractere \n 
dans la chame copiee) ; 

- s'il y a eu une erreur (peu importe laquelle), il faut vider la aussi le buffer par securite 
pour qu'il n'y ait plus rien. 

La fonction viderBuf fer est courte mais dense. Elle lit dans le buffer caractere par 
caractere grace a get char. Cette fonction renvoie un int 3 . On se contente de recuperer 
ce int dans la variable temporaire c. On boucle tant qu'on n'a pas recupere le caractere 
\n ou le symbole EOF (fin de fichier), qui signifient tous deux « vous etes arrive a la 
fin du buffer ». On s'arrete done de boucler des que l'on tombe sur l'un de ces deux 
caracteres. 

C'est un peu complique au premier abord et assez technique, mais <ja fait son tra- 
vail. N'hesitez pas a relire ces explications plusieurs fois si necessaire pour comprendre 
comment <ja fonctionne. 



Convertir la chaine en nombre 

Notre fonction lire est maintenant efficace et robuste, mais elle ne sait lire que 
du texte. Vous devez vous demander : « Mais comment fait-on pour recuperer un 
nombre ? » 

En fait, lire est une fonction de base. Avec fgets, vous ne pouvez recuperer que du 
texte, mais il existe d'autres fonctions qui permettent de convertir ensuite un texte en 
nombre. 



strtol : convertir une chaine en long 

Le prototype de la fonction strtol est un peu particulier : 



3. Et non un char, allez savoir pourquoi, peu importe. 
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I long strtoK const char *start, char **end, int base ); 

La fonction lit la chaine de caracteres que vous lui envoyez (start) et essaie de la 
convertir en long en utilisant la base indiquee (generalement, on travaille en base 10 
car on utilise 10 chiffres differents de a 9, done vous mettrez 10). Elle retourne le 
nombre qu'elle a reussi a lire. Quant au pointeur de pointeur end, la fonction s'en sert 
pour renvoyer la position du premier caractere qu'elle a lu et qui n'etait pas un nombre. 
On ne s'en servira pas, on peut done lui envoyer NULL pour lui faire comprendre qu'on 
ne veut rien recuperer. 

La chaine doit commencer par un nombre, tout le reste est ignore. Elle peut etre 
precedee d'espaces. Quelques exemples d'utilisation pour bien comprendre le principe : 

long i; 

'148", NULL, 10 ) ; // i = 148 
'148.215", NULL, 10 ) ; // i = 148 

148.215", NULL, 10 ) ; // i = 148 
148+34", NULL, 10 ) ; // i = 148 
148 feuilles mortes", NULL, 10 ) ; // i = 148 

II y a 148 feuilles mortes", NULL, 10 ) ; // i = (erreur : la 
chaine ne commence pas par un nombre) 

Toutes les chaines qui commencent par un nombre (ou eventuellement par des espaces 
suivis d'un nombre) seront converties en long jusqu'a la premiere lettre ou au premier 
caractere invalide (., +, etc.). 

La derniere chaine de la liste ne commengant pas par un nombre, elle ne peut pas etre 
convertie. La fonction strtol renverra done 0. 

On peut creer une fonction lireLong qui va appeler notre premiere fonction lire (qui 
lit du texte) et ensuite convertir le texte saisi en nombre : 

long lireLong () 
{ 

char nombreTexte [100] = {0}; // 100 cases devraient suffire 

if (lire (nombreTexte, 100)) 
{ 

// Si lecture du texte ok, convertir le nombre en long et le retourner 

return strtoKnombreTexte, NULL, 10); 
} 

else 
{ 

// Si probleme de lecture, renvoyer 

return ; 
} 
} 



> ( Code web : 220809 ) 
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Vous pouvez tester dans un main tres simple : 

int main(int argc, char *argv[]) 
{ 

long age = 0; 

printf("Quel est votre age ? ") ; 

age = lireLongO ; 

printf("Ah ! Vous avez done */,d ans !\n\n", age); 



return ; 



} 



Quel est votre age ? 18 

Ah ! Vous avez done 18 ans ! 



strtod : convertir une chaine en double 

La fonction strtod est identique a strtol, a la difference pres qu'elle essaie de lire un 
nombre decimal et renvoie un double : 

I double strtod( const char *start, char **end ); 

Vous noterez que le troisieme parametre base a disparu ici, mais il y a toujours le 
pointeur de pointeur end qui ne nous sert a rien. 

Contrairement a strtol, la fonction prend cette fois en compte le « point » decimal. 
Attention, en revanche : elle ne connait pas la virgule 4 . 

A vous de jouer! Ecrivez la fonction lireDouble. Vous ne devriez avoir aucun mal a 
le faire, e'est exactement comme lireLong a part que cette fois, on appelle strtod et 
on retourne un double. 

Vous devriez alors pouvoir faire ceci dans la console : 



Combien pesez-vous ? 67.4 

Ah ! Vous pesez done 67.400000 kg ! 



Essayez ensuite de modifier votre fonction lireDouble pour qu'elle accepte aussi le 
symbole virgule comme separateur decimal. La technique est simple : remplacez la 
virgule par un point dans la chaine de texte lue (grace a la fonction de recherche 
strchr), puis envoyez la chaine modifiee a strtod. 



En resume 

- La fonction scanf , bien qu'en apparence simple d'utilisation, est en fait tres complexe 
et nous oppose certaines limites. On ne peut pas, par exemple, ecrire plusieurs mots 

4. Qa se voit que ga a ete code par des Anglais. 
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a la fois facilement. 

- Un buffer overflow survient lorsqu'on depasse l'espace reserve en memoire, par exemple 
si l'utilisateur entre 10 caracteres alors qu'on n'avait reserve que 5 cases en memoire. 

- L'ideal est de faire appel a la fonction fgets pour recuperer du texte saisi par 
l'utilisateur. 

- II faut en revanche eviter a tout prix d'utiliser la fonction gets qui n'offre pas de 
protection contre le buffer overflow. 

- Vous pouvez ecrire votre propre fonction de saisie du texte qui fait appel a fgets 
comme on l'a fait afin d'ameliorer son fonctionnement. 
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Creation de jeux 2D en SDL 
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Chapitre 



20 



installation de la SDL 



Apartir de maintenant, fini la theorie : nous allons enfin passer au concret ! Dans cette 
nouvelle et importante partie, nous allons nous faire plaisir et pratiquer grace a une 
bibliotheque que Ton appelle la SDL. 

Vous avez deja decouvert la plupart des fonctionnalites du langage C, bien qu'il y ait 
toujours des petits details complexes et croustillants a decouvrir. Ce livre pourrait done 
s'arreter la en annoncant fierement : « C'est bon, vous avez appris a programmer en C I ». 
Pourtant, quand on debute, on n'a en general pas le sentiment de savoir programmer tant 
qu'on n'est pas « sorti » de la console. 

La SDL est une bibliotheque particulierement utilisee pour creer des jeux en 2D. Nous allons 
dans ce premier chapitre en apprendre plus sur cette bibliotheque et decouvrir comment 
I 'installer. 
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On dit que la SDL est une « bibliotheque tierce ». II faut savoir qu'il existe deux types 
de bibliotheques. 

- La bibliotheque standard : c'est la bibliotheque de base qui fonctionne sur tous 
les OS (d'ou le mot « standard ») et qui permet de faire des choses tres basiques 
comme des printf . Elle a ete automatiquement installee lorsque vous avez telecharge 
votre IDE et votre compilateur. Au long des parties I et II, nous avons uniquement 
utilise la bibliotheque standard 1 (stdlib.h, stdio.h, string. h, time.h. . .). 

- Les bibliotheques tierces : ce sont des bibliotheques qui ne sont pas installees 
par defaut. Vous devez les telecharger sur Internet et les installer sur votre ordina- 
tcur. Contrairement a la bibliotheque standard, qui est relativement simple et qui 
contient assez peu de fonctions, il existe des milliers de bibliotheques tierces ecrites 
par d'autres programmeurs. Certaines sont bonnes, d'autres moins, certaines sont 
payantes, d'autres gratuites, etc. l'ideal etant de trouver des bibliotheques de bonne 
qualite et gratuites a la fois ! 

Je ne peux pas faire un cours pour toutes les bibliotheques tierces qui existent. Meme 
en y passant toute ma vie 24h / 24, je ne pourrais pas ! J'ai done fait le choix de 
vous presenter une et une seule bibliotheque ecrite en C et done utilisable par des 
programmeurs en langage C tels que vous. 

Cette bibliotheque a pour nom SDL. Pourquoi ai-je choisi cette bibliotheque plutot 
qu'une autre? Que permet-elle de faire? Autant de questions auxquelles je vais com- 
mencer par repondre. 



Pourquoi avoir choisi la SDL ? 

Choisir une bibliotheque : pas facile ! 

Comme je vous l'ai dit a l'instant, il existe des milliers et des milliers de bibliotheques 
a telecharger. Certaines d'entre elles sont simples, d'autres plus complexes. Certaines 
sont tellement grosses que meme tout un cours comme celui que vous etes en train de 
lire ne suffirait pas ! 

Faire un choix est done dur. De plus, c'est la premiere bibliotheque que vous allez 
apprendre a utiliser (si on ne compte pas la bibliotheque standard), il vaut done mieux 
commencer par une bibliotheque simple. 

J'ai rapidement constate que la majorite de mes lecteurs souhaitait decouvrir comment 
ouvrir des fenetres, creer des jeux, etc. 2 Quant a moi, non seulement j'ai bien envie de 
vous montrer comment on peut faire tout <ja, mais en plus je tiens absolument a vous 
faire pratiquer. En effet, nous avons bien fait quelques TP dans les parties I et II, mais 



1. Nous n'avons pas etudie la bibliotheque standard dans son integralite mais nous en avons vu 
un assez gros morceau. Si vous voulez tout savoir sur la bibliotheque standard, faites une recherche 
sur Google, par exemple, en tapant « C standard library », et vous aurez la liste des prototypes ainsi 
qu'une breve explication de chacune des fonctions. 

2. Enfin, si vous aimez la console on peut continuer longtemps, si vous voulez. . . Non ? Ah bon, 
tiens c'est curieux! 
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ce n'est pas assez. C'est en forgeant que l'on devient forgeron, et c'est en programmant 
que euh. . . Bref, vous m'avez compris ! 

Je suis done parti pour vous a la recherche d'une bibliotheque a la fois simple et 
puissante pour que vous puissiez rapidement realiser vos reves les plus fous (presque) 
sans douleur 3 . 



La SDL est un bon choix ! 

Nous allons etudier la bibliotheque SDL (fig. 20.1). Pourquoi celle-ci et non pas une 
autre ? 




Figure 20.1 - Logo de la SDL 

- C'est une bibliotheque ecrite en C, elle peut done etre utilisee par des program- 
meurs en C tels que vous . 

C'est une bibliotheque libre et gratuite : cela vous evitera d'avoir a investir 
pour lire la suite du livre. Contrairement a ce que l'on pourrait penser, trouver 
des bibliotheques libres et gratuites n'est pas tres difficile, il en existe beaucoup 
aujourd'hui. Une bibliotheque libre est tout simplement une bibliotheque dont vous 
pouvez obtenir le code source. En ce qui nous concerne, voir le code source de la 
SDL ne nous interessera pas. Toutefois, le fait que la bibliotheque soit libre vous 
garantit plusieurs choses, notamment sa perennite (si le developpeur principal arrete 
de s'en occuper, d'autres personnes pourront la continuer a sa place) ainsi que sa 
gratuite le plus souvent. La bibliotheque ne risque done pas de disparaitre du jour 
au lendemain. 

Vous pouvez realiser des programmes commerciaux et propriet aires avec. 
Certes, c'est peut-etre un peu trop vouloir anticiper, mais autant choisir une biblio- 
theque gratuite qui vous laisse un maximum de libertes. En effet, il existe deux types 
de bibliotheques libres : 

- les bibliotheques sous license GPL : elles sont gratuites et vous pouvez avoir le 
code source, mais vous etes obliges en contrepartie de fournir le code source des 
programmes que vous realisez avec ; 

- les bibliotheques sous license LGPL : c'est la meme chose, sauf que cette fois 
vous n'etes pas obliges de fournir le code source de vos programmes. Vous pouvez 
done realiser des programmes proprietaries avec. 



3. Tout est relatif, bien sur! 

4. Notez que comme la plupart des bibliotheques ecrites en C, il est possible de les utiliser en CH 
ainsi que dans d'autres langages. 
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Bien qu'il soit possible juridiquement de ne pas diffuser votre code source, 
je vous invite a le faire quand meme. Vous pourrez ainsi obtenir des conseils 
de programmeurs plus experimentes que vous. Cela vous permettra de vous 
ameliorer. Apres, c'est vous qui choisirez de realiser des programmes libres 
ou proprietaires, c'est surtout une question de mentalite. Je ne rentrerai pas 
dans le debat ici, pas plus que je ne prendrai position : on peut tirer du bon 
comme du mauvais dans chacun de ces deux types de programmes. 




a 



C'est une bibliotheque multi-plates-formes. Que vous soyez sous Windows, Mac 
ou Linux, la SDL fonctionnera chez vous. C'est meme d'ailleurs ce qui fait que cette 
bibliotheque est impressionnante aux yeux des programmeurs : elle fonctionne sur 
un tres grand nombre de systemes d'exploitation. II y a Windows, Mac et Linux 
certes, mais elle peut aussi fonctionner sur Atari, Amiga, Symbian, Dreamcast, etc. 
En clair, vos programmes pourraient tres bien fonctionner sur de vieilles machines 
comme 1' Atari 5 ! 

- Enfin, la bibliotheque permet de faire des choses amusantes. Je ne dis pas qu'une 
bibliotheque mathematique capable de resoudre des equations du quatrieme degre 
n'est pas interessante, mais je tiens a ce que ce cours soit ludique autant que possible 
afin de vous motiver a programmer. 

La SDL n'est pas une bibliotheque specialement concue pour creer des jeux video. Je 
l'admets, la plupart des programmes utilisant la SDL sont des jeux video, mais cela ne 
veut pas dire que vous etes forcement obliges d'en creer. A priori, tout est possible avec 
plus ou moins de travail, j'ai deja eu l'occasion de voir des editeurs de texte developpes 
a l'aide de la SDL, bien qu'il y ait plus adapte 6 . 

Les possibilities offertes par la SDL 

La SDL est une bibliotheque bas niveau. Vous vous souvenez de ce que je vous avais 
dit au tout debut du cours a propos des langages haut niveau et bas niveau ? Eh bien 
ca s'applique aussi aux bibliotheques. 

- Une bibliotheque bas niveau : c'est une bibliotheque disposant de fonctions tres 
basiques. II y a en general peu de fonctions car on peut tout faire avec elles. Comme 
les fonctions restent basiques, elles sont tres rapides. Les programmes realises a l'aide 
d'une telle bibliotheque sont done en general ce qui se fait de plus rapide. 

- Une bibliotheque haut niveau : elle possede beaucoup de fonctions capables 
d'executer de nombreuses actions. Cela la rend plus simple d'utilisation. Toutefois, 
une bibliotheque de ce genre est generalement « grosse », done plus difficile a etudier 
et a connaitre integralement. En outre, elle est souvent plus lente qu'une bibliotheque 
bas niveau (bien que parfois, <ja ne soit pas vraiment visible). 

Bien entendu, il faut nuancer. On ne peut pas dire « une bibliotheque bas niveau est 
mieux qu'une bibliotheque haut niveau » ou l'inverse. Chacun des deux types presente 



5. II faudrait neanmoins faire quelques petites adaptations et peut-etre utiliser un compilateur 
special. Nous n'en parlerons pas ici. 

6. Si vous souhaitez developper des interfaces graphiques classiques sous forme de fenetres (boutons, 
menus, etc.), je vous invite a vous renseigner plutot sur GTK+. 
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des qualites et des defauts. La SDL que nous allons etudier fait plutot partie des 
bibliotheques bas niveau. 

II faut done retenir que la SDL propose surtout des fonctions basiques. Vous avez par 
exemple la possibility de dessiner pixel par pixel, de dessiner des rectangles ou encore 
d'afficher des images. C'est tout, et e'est suffisant. 

- En faisant bouger une image, vous pouvez faire se deplacer un personnage. 

- En affichant plusieurs images d'affilee, vous pouvez creer une animation. 

- En combinant plusieurs images cfite a cote, vous pouvez creer un veritable jeu. 

Pour vous donner une idee de jeu realisable avec la SDL, sachez que l'excellent « Civi- 
lization : Call to power » a ete adapte pour Linux a l'aide de la bibliotheque SDL (fig. 
20.2). 




Figure 20.2 - Le jeu Civilization : Call to power utilise la SDL 



Ce qu'il faut bien comprendre, c'est qu'en fait tout depend de vous et eventuellement 
de votre equipe. Vous pouvez faire des jeux encore plus beaux si vous avez un graphiste 
doue sous la main. 

La seule limite de la SDL, c'est la 2D. Elle n'est en effet pas congue pour la 3D. Voici 
une liste de jeux que l'on peut parfaitement concevoir en SDL (ce n'est qu'une petite 
liste, tout est possible a priori tant que <ja reste de la 2D) : 

- Casse-briques ; 

- Bomberman ; 

- Tetris; 

- jeux de plate-forme : Super Mario Bros, Sonic, Rayman. . . 

- RPG 2D : Zelda, les premiers Final Fantasy, etc. 
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II m'est impossible de faire une liste complete, la seule limite ici etant l'imagination. 
J'ai d'ailleurs vu un des lecteurs de ce cours realiser un croisement ose entre un casse- 
briques et un Tetris. 

Redescendons sur Terre et reprenons le fil de ce cours. Nous allons maintenant installer 
la SDL sur notre ordinateur avant d'aller plus loin. 

Telechargement de la SDL 

Le site de la SDL (www. libsdl . org) devrait bientot devenir incontournable pour vous. 
La-bas, vous trouverez tout ce dont vous avez besoin, en particulier la bibliotheque 
elle-meme a telecharger ainsi que sa documentation. 

> ( Code web : 480724 ) 

Sur le site de la SDL, rendez-vous dans le menu a gauche, section Download. Telechargez 
la version de la SDL la plus recente que vous voyez 7 . 

La page de telechargement est separee en plusieurs parties. 

- Source code : vous pouvez telecharger le code source de la SDL. Comme je vous 
l'ai dit, le code source ne nous interesse pas. Je sais que vous etes curieux et que 
vous voudriez savoir comment c'est fait a l'interieur, mais actuellement <ja ne vous 
apportera rien. Pire, ga vous embrouillera et ce n'est pas le but. 

- Runtime libraries : ce sont les fichiers que vous aurez besoin de distribuer en 
meme temps que votre executable lorsque vous donnerez votre programme a d'autres 
personnes. Sous Windows, il s'agit tout simplement d'un fichier SDL.dll. Celui-ci 
devra se trouver : 

- soit dans le meme dossier que l'executable (ce que je recommande 8 ) ; 

- soit dans le dossier c:\Windows. 

- Development libraries : ce sont les fichiers .a (ou .lib sous Visual) et .h vous 
permettant de creer des programmes SDL. Ces fichiers ne sont necessaires que pour 
vous, le programmeur. Vous n'aurez done pas a les distribuer avec votre programme 
une fois qu'il sera fini. Si vous etes sous Windows, on vous propose trois versions 
dependant de votre compilateur : 

- VC6 : pour ceux qui utilisent Visual Studio payant dans une vieille version (ce qui 
a peu de chances de vous concerner) ; vous y trouverez des fichiers .lib; 

- VC8 : pour ceux qui utilisent Visual Studio 2005 Express ou ulterieur ; vous y 
trouverez des fichiers .lib ; 

- mingw32 : pour ceux qui utilisent Code: :Blocks (il y aura done des fichiers .a). 

La particularite, c'est que les « Development libraries » contiennent tout ce qu'il faut : 
les . h et .a (ou . lib) bien sur, mais aussi la SDL . dll a distribuer avec votre application 
ainsi que la documentation de la SDL ! Bref, tout ce que vous avez a faire au final est 

7. SDL 1.2 au moment ou j'ecris ces lignes. 

8. L'ideal est de toujours dormer la DLL avec votre executable et de la laisser dans le meme dossier. 
Si vous placez la DLL dans le dossier de Windows, vous n'aurez plus besoin de joindre une DLL dans 
chaque dossier contenant un programme SDL. Toutefois, cela peut poser des problemes de conflits de 
version si vous ecrasez une DLL plus recente. 
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de telecharger les « Development libraries ». Tout ce dont vous avez besoin s'y trouve. 



© 




t 



O 



Ne vous trompez pas de lien ! Prenez bien la SDL dans la section « Develop- 
ment libraries » et non le code source de la section « Source code » I 



Qu'est-ce que la documentation? 



Une documentation, c'est la liste complete des fonctions d'une bibliotheque. Toutes 
les documentations sont ecrites en anglais (oui, meme les bibliotheques ecrites par des 
Francais ont leur documentation en anglais). Voila une raison de plus pour progresser 
dans la langue de Shakespeare ! 

La documentation n'est pas un cours, elle est en general assez austere. L'avantage 
par rapport a un cours, c'est qu'elle est complete. Elle contient la liste de toutes les 
fonctions, c'est done LA reference du programmeur. Bien souvent, vous rencontrerez des 
bibliotheques pour lesquelles il n'y a pas de cours. Vous aurez uniquement la « doc' » 
comme on l'appelle, et vous devrez etre capables de vous debrouiller avec seulement ca 
(meme si parfois c'est un peu dur de demarrer sans aide). Un vrai bon programmeur 
peut done decouvrir le fonctionnement d'une bibliotheque uniquement en lisant sa doc'. 

A priori, vous n'aurez pas besoin de la doc' de la SDL de suite car je vais moi-meme 
vous expliquer comment elle fonctionne. Toutefois, c'est comme pour la bibliotheque 
standard : je ne pourrai pas vous parler de toutes les fonctions. Vous aurez done cer- 
tainement besoin de lire la doc' plus tard. 

La documentation se trouve deja dans le package « Development libraries », mais 
si vous le voulez vous pouvez la telecharger a part en vous rendant dans le menu 
Documentation / Downloadable. Je vous recommande de placer les fichiers HTML 
de la documentation dans un dossier special (intitule par exemple Doc SDL) et de 
faire un raccourci vers le sommaire index.html. Le but est que vous puissiez acceder 
rapidement a la documentation lorsque vous en avez besoin. 



Creer un projet SDL 

L'installation d'une bibliotheque est en general un petit peu plus compliquee que les 
installations dont vous avez l'habitude. Ici, il n'y a pas d'installeur automatique qui vous 
demande simplement de cliquer sur Suivant - Suivant - Suivant - Terminer. 

En general, installer une bibliotheque est assez difficile pour un debutant. Pourtant, 
si ca peut vous remonter le moral, l'installation de la SDL est beaucoup plus simple 
que bien d'autres bibliotheques que j'ai eu l'occasion d'utiliser (en general on ne vous 
donne que le code source de la bibliotheque, et c'est a vous de la recompiler !). 

En fait, le mot « installer » n'est peut-etre pas celui qui convient le mieux. Nous n'allons 
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rien installer du tout : nous voulons simplement arriver a creer un nouveau projet de 
type SDL avec notre IDE. Or, selon l'IDE que vous utilisez la manipulation sera un 
peu differente. Je vais presenter la manipulation pour chacun des IDE que je vous ai 
presentes au debut du cours pour que tout le monde puisse suivre. 

Je vais maintenant vous montrer comment creer un projet SDL sous chacun de ces 
trois IDE. 



Creation d'un projet SDL sous Code: :Blocks 

1/ Extraction des fichiers de la SDL 

Ouvrez le fichier compresse de « Development Libraries » que vous avez telecharge. Ce 
fichier est un .zip pour Visual et un .tar.gz pour mingw32 (il vous faudra un logiciel 
comme Winrar ou 7-Zip pour decompresser le .tar.gz). 

Le fichier compresse contient plusieurs sous-dossiers. Ceux qui nous interessent sont les 
suivants : 

- bin : contient la . dll de la SDL ; 

- docs : contient la documentation de la SDL ; 

- include : contient les . h ; 

- lib : contient les .a (ou .lib pour Visual). 

Vous devez extraire tous ces fichiers et dossiers quelque part sur votre disque dur. Vous 
pouvez par exemple les placer dans le dossier de Code: :Blocks, dans un sous-dossier 
SDL (fig. 20.3). 

Dans mon cas, la SDL sera installee dans le dossier : 

C:\Program Files\CodeBlocks\SDL-l . 2 . 13 

Retenez bien le nom du dossier dans lequel vous l'avez installee, vous allez en avoir 
besoin pour configurer Code: :Blocks. 

Maintenant, il va falloir faire une petite manipulation pour simplifier la suite. Allez 
dans le sous-dossier include/SDL 9 . Vous devriez y voir de nombreux petits fichiers .h. 
Copiez-les dans le dossier parent, c'est-a-dire dans : 

C:\Program Files\CodeBlocks\SDL-l . 2 . 13\include 

La SDL est installee! II faut maintenant configurer Code: :Blocks. 

2/ Creation du projet SDL 

Ouvrez maintenant Code: :Blocks et demandez a creer un nouveau projet. 

Au lieu de creer un projet Console Application comme vous aviez l'habitude de faire, 
vous allez demander a creer un projet de type SDL project. 

La premiere fenetre de l'assistant qui apparait ne sert a rien, cliquez sur Next. On vous 



9. Dans mon cas, il se trouve dans C:\Program Files\CodeBlocks\SDL-1.2.13\include\SDL. 
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■ <°) i- % I 



ivl « Programme: ► CodeBlocks ► t \4f \\Rechercher 




Figure 20.3 - Le dossier de la SDL dezippe 



demande ensuite le nom de votre projet et le dossier dans lequel il doit etre place, 
comme vous l'avez toujours fait (fig. 20.4). 



SDL project 




— MM 


r 

1 c 


J 

) 


Please select the folder where you want the new project 
to be created as well as its titie. 

Project titie: 


testsdl 


Folder to create project in: 


C:yj5ersV v lateoV 5 rojets\ 1 ... I 
Project filename: 


testsdl. cbp 
Resulting filename: 


C : 'JJsers '>Mateo 'f rojets \testsdl \testsdl . cbp 








<Ea<± | Next> | Cancel 









Figure 20.4 - Assistant SDL et nom de projet 
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Vient ensuite la partie cm vous devez indiquer ou se trouve installee la SDL (fig. 20.5). 



SDL project 



"DID 



Q 



Please select the location of SDL on your computer. 
This is the top-level folder where SDL was installed [unpacked). 
To help you r this folder must contain the subfolders 
Include'' and lib'. 

Please select SDL's location: 



5(*sdl) 



< Back Next > 



Figure 20.5 - Assistant SDL et configuration 

Cliquez sur le bouton ... a droite. Une nouvelle fenetre un peu complexe s'ouvre (fig 
20.6). 



Global Variable Editor 






! 1 




Current Set: | default ▼ 


Clone 


| | New | | 


Delete 








Current Variable: |sdl ▼ 


Clone 


1 1 «™ 1 1 


Delete 








1 Builtin fields 




User-defined fields 






Q 




1 base C: program Files\CodeBlocks£DL-l 
the base member is mandatory 










| 







include 
lib 
V obj 




| 








1 


cflags 






1 flags 

■0 


L 






Close 













Figure 20.6 - Localisation de la SDL 
Vous devez simplement remplir le champ nomme base. Indiquez le dossier ou vous avez 
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decompresses la SDL. Dans mon cas, c'est : 

C:\Program Files\CodeBlocks\SDL-l .2 . 13 

Cliquez sur Close. Une nouvelle fenetre apparait. C'est une fenetre-piege (dont je n'ai 
toujours pas saisi l'interet). Elle vous demande un dossier. Cliquez sur Annuler pour 
ne rien faire. 

Cliquez ensuite sur Next dans l'assistant, puis choisissez de compiler en mode Release 
ou Debug (peu importe) et enfin, choisissez Finish. 

Code: :Blocks va creer un petit projet SDL de test comprenant un main, c et un fichier 
.bmp. Avant d'essayer de le compiler, copiez la DLL de la SDL 10 dans le dossier de 
votre projet. 

Essayez ensuite de compiler : une fenetre avec une image devrait s'afficher. Bravo, ca 
fonctionne ! 

Si on vous dit « Cette application n'a pas pu demarrer car SDL.dll est introu- 
vable », c'est que vous n'avez pas copie le fichier SDL.dll dans le dossier de 
votre projet I II faudra penser a fournir cette .dll en plus de votre .exe a 
vos amis si vous voulez qu'ils puissent eux aussi executer le programme. En 
revanche, vous n'avez pas besoin de leur joindre les .net .a qui n'interessent 
que vous. 




a 



Vous pouvez supprimer le .bmp du programme, on n'en aura pas besoin. Quant au 
fichier main, c, il est un peu long, on ne va pas demarrer avec ca. Supprimez tout son 
contenu et remplacez-le par : 



#include <stdlib.h> 
#include <stdio.h> 
#include <SDL/SDL.h> 

int main(int argc, char *argv[]) 
{ 

return ; 
} 



t> ( Code web : 578930 ) 



C'est en fait un code de base tres similaire a ceux que l'on connait (un include dc 
stdlib, un autre de stdio, un main. . .). La seule chose qui change, c'est le include 
d'un fichier SDL.h. C'est le fichier .h de base de la SDL qui se chargera d'inclure tous 
les autres fichiers .h de la SDL. 



10. Vous devriez l'avoir copiee dans C:\Program Files\CodeBlocks\SDL-l .2. 13\bin\SDL.dll. 
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Creation d'un projet SDL sous Visual CH — h 

1/ Extraction des fichiers de la SDL 

Sur le site de la SDL, telechargez la derniere version de la SDL. Dans la section « De- 
velopment Libraries », prenez la version pour Visual C++ 2005 Service Pack 1. 

Ouvrez le fichier zip. II contient la doc' (dossier docs), les .h (dossier include), et les 
.lib (dossier lib) qui sont l'equivalent des .a pour le compilateur de Visual. Vous 
trouverez aussi le fichier SDL.dll dans ce dossier lib. 

- Copicz SDL.dll dans le dossier de votre projet. 

- Copiez les .lib dans le dossier lib de Visual C++. Par exemple chez moi il s'agit 
du dossier : C:\Program Files\Microsoft Visual Studio 8\VC\lib. 

- Copiez les .h dans le dossier includes dc Visual C++. Creez un dossier SDL dans ce 
dossier includes pour regrouper les .h de la SDL entre eux. Chez moi, je mets done 
les .h dans : C:\Program Files\Microsoft Visual Studio 8\VC\include\SDL. 



2/ Creation d'un nouveau projet SDL 

Sous Visual CH — h, creez un nouveau projet de type Application console Win32. 
Appelez votre projet testsdl par exemple. Cliquez sur OK. 

Un assistant va s'ouvrir. Allez dans Parametres de 1' application et verifiez que 
Projet vide est coche (fig. 20.7). 



^'■'""""""■'■■ vi '""*-'-"' 



M 



Parametres de 1'application 



Vue d'ensemble 
Parametres de 1'application 



Type d'application : 

Application Windows 
© Application console 

Bibliotheque statique 
Options supplementaires : 

[^1 Projet vide 

1 I Exporter des symboles 
[^1 En-tete p_recompile 



"! 



Ajouter les fichiers d'en-tete courants 
pour : 

□ atl 

□ mfc 



< Precedent ' Terminer Annuler 



Figure 20.7 - Cochez Projet vide 
Le projet est alors cree. II est vide. Ajoutez-y un nouveau fichier en faisant un clic droit 
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sur Fichiers sources, A j outer / Nouvel element (fig. 20. J 



Bi» 

^3 Solution 'testsdl' (1 projet) 
G lP testsdl 

Lt3 Fichiers d'en-fcete 
f^3 Fichiers de ressources 

□I 



j( Couper 
l^ Copier 

X Supprimer 

Renommer 

oj] Proprietes 




Figure 20.8 - Ajout d'un nouveau fichier 

Dans la fenetre qui s'ouvre, demandez a creer un nouveau fichier de type Fichier C++ 
( . cpp) que vous appellerez main. c. En utilisant l'extension . c dans le nom du fichier, 
Visual creera un fichier . c et non un fichier . cpp. 

Ecrivez (ou copiez-collez) le code « de base » mentionne precedemment dans votre 
nouveau fichier vide. 



3/ Configuration du projet SDL sous Visual CH — |- 

La configuration du projet est un peu plus delicate que pour Code: :Blocks, mais 
elle reste humainement faisable. Allez dans les proprietes de votre projet : Projet 
/ Proprietes de testsdl. 

- Dans la section C / C++ => Generation de code, mettez le champ Bibliotheque 
runtime a DLL multithread (/MD). 

- Dans la section C/C++ => Avance, selectionnez Compilation sous et optez pour 
la valeur Compiler comme code C (/TC) (sinon Visual vous compilera votre projet 
comme etant du C++). 

- Dans la section Editeur de liens => Entree, modifiez la valeur de Dependances 
supplementaires pour y ajouter SDL. lib SDLmain.lib. 

- Dans la section Editeur de liens => Systeme, modifiez la valeur de Sous-systeme 
et mettez- la a Windows (fig. 20.9). 

Validez ensuite vos modifications en cliquant sur OK et enregistrez le tout. Vous pouvez 
maintenant compiler en allant dans le menu Generer / Generer la solution. 

Rendez-vous dans le dossier de votre projet pour y trouver votre executable (il sera 
peut-etre dans un sous-dossier Debug). N'oubliez pas que le fichier SDL.dll doit se 
trouver dans le meme dossier que l'executable. Double-cliquez sur votre . exe : si tout 
va bien, il ne devrait rien se passer. Sinon, s'il y a une erreur c'est probablement que 
le fichier SDL.dll ne se trouve pas dans le meme dossier. 
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Pages de proprietes de tests dL 



Configuration : | Active(Debug) [vj Plate-forme : Active(Win32) [vj | Gestionnaire de configurations,, 



©■■ Proprietes communes 


- 


B- Proprietes de configuration 






■■■ General 






■■■ Debogage 






!■■ Editeur de liens 








— General 








— Entree 








— Fichier manifesto 








■■■ Debogage 








■■■ Systeme 








Optimisation 








IDL incorpore 








— Avance 








— Ligne de commande 






i- Outil Manifesto 






1 Generateur de document 






1 Informations de consultat 






1 Evenements de generatio 




E 


Etape de generation pers 


V 







Taille de la reserve de tas 
Taille de la validation des tas 
T bille de lb i ever e de pile*.- 
Taille de validation de pile 
Activation des longues adresses 
Terminal Server 
Echange a partir du CD-ROM 
Echange a partir du reseau 
Pilote 


| Windows (/SUBSYSTEM:WINDOWS) 





Par defaut 


[v] 


Par defaut 


Non 


Non 


Non defini 






Sous-systeme 

Spedfie le sous-systeme pour I'editeur de liens. (/SUBSYSTEM: [type]) 



Appliquer 



Figure 20.9 - Configuration de Visual pour la SDL 



Creation d'un projet SDL avec Xcode (Mac OS X) 

Cette section a ete a l'origine redigee par guimers8 du Site du Zero, que je remercie a 
nouveau au passage. 

Commencez par telecharger la version de la SDL sur le site officiel. Le fichier doit avoir 
l'extension .dmg. Montez (chargez) ce fichier .dmg, prenez le dossier .framework (par 
exemple : SDL. framework) et placez-le dans le dossier : 

<Racine Disque>/Bibliotheque/Frameworks 

Un dossier .framework est un dossier contenant tous les fichiers necessaires, comme 
les binaires de la SDL et les headers (fig. 20.10). 
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Figure 20.10 - Les frameworks dans leur dossier 
Allez dans l'archive de la SDL (SDL-1.2. ll.dmg), puis dans le dossier devel-lite et 
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prenez les fichiers SDLMain . m et SDLMain . h. Placez-les en lieu sur. 

II va falloir recuperer un fichier supplementaire, maintenant : SDL-1 . 2 . 12-extras . dmg 
que vous trouverez sur le site de la SDL. II est compose de deux dossiers : 

- TemplatesForProjectBuilder 

- TemplatesForXcode 

Copiez-les dans : 

Macintosh HD/Developer/Library/Xcode/Project Templates/ 

L'assistant de creation de nouveau projet de XCode vous proposera alors de creer une 
SDL Application (fig. 20.11). 

O New Projecr 



Choose a template for your new project: 



■ 


Phone OS 


Appli 


aricr 


JL 


JserTemplat-ei 


Appli 


atior 


* 


Mac 05 X 


Annli 


srinn 



v iV 



Figure 20.11 - XCode propose de creer un projet SDL 
Et voila, votre projet est cree ! 



Et sous Linux ? 

Si vous compilez sous Linux avec un IDE, il faudra modifier les proprietes du projet (la 
manipulation sera quasiment la meme). Si vous utilisez Code: :Blocks (qui existe aussi 
en version Linux) vous pouvez suivre la meme procedure que celle que j'ai decrite plus 
haul. 




V 



o 



Et pour ceux qui compilent a la main? 



II y en a peut-etre parmi vous qui ont pris l'habitude de compiler a la main sous Linux 
a l'aide d'un Makefile (fichier commandant la compilation). Si c'est votre cas, je vous 
invite a telecharger un Makefile que vous pouvez utiliser pour compiler des projets 
SDL. 

> ( Code web : 619525 ) 

La seule chose un peu particuliere, c'est l'ajout de la bibliotheque SDL pour le linker 
(LDFLAGS). II faudra que vous ayez telecharge la SDL version Linux et que vous l'ayez 
installee dans le dossier de votre compilateur, de la meme maniere qu'on le fait sous 
Windows (dossiers include/SDL et lib) 

Ensuite, vous pourrez utiliser les commandes suivantes dans la console : 
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make 


#Pour 


compiler le pro jet 


make 


clean #Pour 


ef facer les fichiers de compilation (.0 inutiles) 


make 


mrproper #Pour 


tout supprimer sauf les fichiers source 



En resume 

- La SDL est une bibliotheque de bas niveau qui permet d'ouvrir des fenetres et d'y 
faire des manipulations graphiques en 2D. 

- Elle n'est pas installee par defaut, il faut la telecharger et configurer votre IDE pour 
l'utiliser. 

- Elle est libre et gratuite, ce qui vous permet de l'utiliser rapidement et vous garantit 
sa perennite. 

- II existe des milliers d'autres bibliotheques dont beaucoup sont de tres bonne qualite. 
C'est la SDL qui a ete selectionnee pour la suite de ce cours pour son aspect ludique. 
Si vous souhaitez developper des interfaces completes avec menus et boutons par la 
suite, je vous invite a vous pencher sur la bibliotheque GTK+ par exemple. 
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Chapitre 



21 



Creation d'une fenetre et de surfaces 



Dans le chapitre precedent, nous avons fait un petit tour d'horizon de la SDL pour 
decouvrir les possibilites que cette bibliotheque nous offre. Vous I'avez normalement 
telechargee et vous etes capables de creer un nouveau projet SDL valide sans aucun 
probleme. Celui-ci est toutefois encore tres vide. 

Nous attaquons le vif du sujet des ce chapitre. Nous allons poser les bases de la program- 
mation en C avec la SDL. Comment charger la SDL? Comment ouvrir une fenetre aux 
dimensions desirees? Comment dessiner a I'interieur de la fenetre? 

Nous avons du pain sur la planche. Allons-y! 
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Charger et arreter la SDL 

Un grand nombre de bibliotheques ecrites en C necessitent d'etre initialisees et fermees 
par des appels a des fonctions. La SDL n'echappe pas a la regie. 

En effet, la bibliotheque doit charger un certain nombre d'informations dans la memoire 
pour pouvoir fonctionner correctement. Ces informations sont chargees en memoire dy- 
namiquement par des malloc (ils sont tres utiles ici !). Or, comme vous le savez, qui dit 
malloc dit. . . free ! Vous devez liberer la memoire que vous avez allouee manuellement 
et dont vous n'avez plus besoin. Si vous ne le faites pas, votre programme va prendre 
plus de place en memoire que necessaire, et dans certains cas ga peut etre carrement 
catastrophique 1 . 

Void done les deux premieres fonctions de la SDL a connaitre : 

- SDL_Init : charge la SDL en memoire (des malloc y sont faits) ; 

- SDL_Quit : libere la SDL de la memoire (des free y sont faits). 

La toute premiere chose que vous devrez faire dans votre programme sera done un 
appel a SDL_Init, et la derniere un appel a SDL_Quit. 



SDL_Init : chargement de la SDL 

La fonction SDL_Init prend un parametre. Vous devez indiquer quelles parties de la 
SDL vous souhaitez charger. 




H Ah bon, la SDL est composee de plusieurs parties? 



O 



Eh oui ! II y a une partie de la SDL qui gere l'affichage a l'ecran, une autre qui gere le 
son, etc. 

La SDL met a votre disposition plusieurs constantes pour que vous puissiez indiquer 
quelle partie vous avez besoin d'utiliser dans votre programme (tab. 21.1). 

Si vous appelez la fonction comme ceci : 

| SDL_Init(SDL_INIT_VIDEO) ; 

. . . alors le systeme video sera charge et vous pourrez ouvrir une fenetre, y dessiner, 
etc. En fait, tout ce que vous faites e'est envoyer un nombre a SDL_Init a l'aide d'une 
constante. Vous ne savez pas de quel nombre il s'agit, et justement e'est <ja qui est bien. 
Vous avez juste besoin d'ecrire la constante, e'est plus facile a lire et a retenir. 

La fonction SDL_Init regardera le nombre qu'elle regoit et en fonction de cela, elle 
saura quels systemes elle doit charger. 



1. Imaginez que vous fassiez une boucle infinie de malloc sans le faire expres : en quelques secondes, 
vous saturerez toute votre memoire ! 
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Const ante 

SDL_INIT_VIDEO 



Description 

Charge le systeme d'affichage (video). C'est la partie que 
nous chargerons le plus souvent. 



SDL INIT AUDIO 



Charge le systeme de son. Vous permettra done par exemple 
de jouer de la musique. 



SDL_INIT_CDRGM 



SDL_INIT_JOYSTICK 



Charge le systeme de CD-ROM. Vous permettra de mani- 

puler votre lecteur de CD-ROM 

Charge le systeme de gestion du joystick. 



SDL INIT TIMER 



Charge le systeme de timer. Cela vous permet de gerer le 
temps dans votre programme (tres pratique). 



SDL_INIT_EVERYTHING Charge tous les systemes listes ci-dessus a la fois. 



Table 21.1 - Liste des constantes de chargement de la SDL 



Maintenant, si vous faites : 



| SDL_Init(SDL_INIT_EVERYTHING) ; 



. . . vous chargez tous les sytemes de la SDL. Ne faites cela que si vous avez vraiment 
besoin de tout, il est inutile de surcharger votre ordinateur en chargeant des modules 
dont vous ne vous servirez pas. 




Supposons que je veuille charger I'audio et la video seulement. Dois-je utiliser 
SDL INIT EVERYTHING? 



Vous n'allez pas utiliser SDL_INIT_EVERYTHING juste parce que vous avez besoin de 
deux modules, pauvres fous ! Heureusement, on peut combiner les options a l'aide du 
symbole I (la barre verticale). 



// Chargement de la video et de I'audio 
SDL_Init(SDL_INIT_VIDEO I SDL_INIT_AUDIO) ; 



Vous pouvez aussi en combiner trois sans probleme : 



// Chargement de la video, de I'audio et du timer 
SDL_Init(SDL_INIT_VIDEO I SDL_INIT_AUDIO I SDL_INIT_TIMER) ; 




O 



Ces « options » que I 'on envoie a SDL_Init sont aussi appelees flags. C'est 
quelque chose que vous rencontrerez assez souvent. Retenez bien qu'on utilise 
la barre verticale I pour combiner les options. Ca agit un peu comme une 
addition. 
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SDL_Qu.it : arret de la SDL 

La fonction SDL_Quit est tres simple a utiliser vu qu'elle ne prend pas de parametre : 

| SDL_Quit() ; 

Tous les systemes initialises seront arretes et liberes de la memoire. Bref, c'est un moyen 
de quitter la SDL proprement, a faire a la fin de votre programme. 

Canevas de programme SDL 

En resume, voici a quoi va ressembler votre programme SDL dans sa version la plus 
simple : 

#include <stdlib.h> 
#include <stdio.h> 
#include <SDL/SDL.h> 

int main(int argc, char *argv[]) 
{ 

SDL_Init(SDL_INIT_VIDEO) ; // Demarrage de la SDL (ici : chargement du 
«-> systeme video) 

/* 

La SDL est chargee. 

Vous pouvez mettre ici le contenu de votre programme 

*/ 

SDL_Quit(); // Arret de la SDL (liberation de la memoire). 

return 0; 



t> ( Code web : 357096 ) 

Bien entendu, aucun programme « serieux » ne tiendra dans le main. Ce que je fais 
la est schematique. Dans la realite, votre main contiendra certainement de nombreux 
appels a des fonctions qui feront elles aussi plusieurs appels a d'autres fonctions. Cc 
qui compte au final, c'est que la SDL soit chargee au debut et qu'elle soit fermee a la 
fin quand vous n'en avez plus besoin. 



Gerer les erreurs 

La fonction SDL_Init renvoie une valeur : 

— 1 en cas d'erreur; 

- si tout s'est bien passe. 

308 



CHARGER ET ARRETER LA SDL 



Vous n'y etes pas obliges, mais vous pouvez verifier la valeur retournee par SDL_Init. 
Ca peut etre un bon moyen de traiter les erreurs de votre programme et done de vous 
aider a les resoudre. 




Mais comment afficher I'erreur qui s'est produite? 



Excellente question ! On n'a plus de console maintenant, done comment faire pour 
stocker et afficher des messages d'erreurs ? 

Deux possibilites : 

- soit on modifie les options du projet pour qu'il affiche a nouveau la console. On 
pourra alors faire des printf ; 

- soit on ecrit dans un fichier les erreurs. On utilisera fprintf . 

J'ai choisi d'ecrire dans un fichier. Cependant, ecrire dans un fichier implique de faire 
un f open, un f close. . . bref, e'est un peu moins facile qu'un printf. Heureusement, 
il y a une solution plus simple : utiliser la sortie d'erreur standard. 

II y a une variable stderr qui est definie par stdio.h et qui pointe vers un endroit 
ou I'erreur peut etre ecrite 2 . Cette variable est automatiquement creee au debut du 
programme et supprimee a la fin. Vous n'avez done pas besoin de faire de f open ou de 
f close. Vous pouvez done faire un fprintf sur stderr sans utiliser f open ou f close : 

#include <stdlib.h> 
#include <stdio.h> 
#include <SDL/SDL.h> 

int main(int argc, char *argv[]) 
{ 

if (SDL_Init(SDL_INIT_VIDEO) == -1) // Demarrage de la SDL. Si erreur : 
{ 

fprintf (stderr , "Erreur d' initialisation de la SDL : */,s\n", 
'—¥ SDL_GetError () ) ; // Ecriture de I'erreur 

exit (EXIT_FAILURE) ; // On quitte le programme 
} 



SDL_Quit() ; 

return EXIT_SUCCESS; 



> ( Code web : 712690 ) 
Quoi de neuf dans ce code ? 

2. Generalement sous Windows, ce sera un fichier stderr.txt tandis que sous Linux, I'erreur ap- 
paraitra le plus souvent dans la console. 
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- On ecrit dans stderr notre erreur. Le °/„s permet de laisser la SDL indiquer les details 
de l'erreur : la fonction SDL_GetError() renvoie en effet la derniere erreur de la SDL. 

- On quitte en utilisant exit(). Jusque-la, rien de nouveau. Toutefois, vous aurez 
remarque que j 'utilise une constante (EXIT_FAILURE) pour indiquer la valeur que 
renvoie le programme. De plus, a la fin j 'utilise EXIT_SUCCESS au lieu de 0. Qu'est-ce 
que j'ai change ? En fait j'ameliore petit a petit nos codes source. En effet, le nombre 
qui signifie « erreur » par exemple peut etre different selon les ordinateurs ! Cela 
depend la encore de l'OS. Pour pallier ce probleme, stdlib.h nous fournit deux 
constantes (des define) : 

- EXIT_FAILURE : valeur a renvoyer en cas d'echec du programme ; 

- EXIT_SUCCESS : valeur a renvoyer en cas de reussite du programme. 

En utilisant ces constantes au lieu de nombres, vous etes certains de renvoyer une 
valeur correcte quel que soit l'OS. Pourquoi? Parce que le fichier stdlib.h change 
selon l'OS sur lequel vous etes, done les valeurs des constantes sont adaptees. Votre 
code source, lui, n'a pas besoin d'etre modifie ! C'est ce qui rend le langage C com- 
patible avec tous les OS 3 . 

Cela n'a pas de grandes consequences pour nous pour le moment, mais c'est 
plus serieux d'utiliser ces constantes. C'est done ce que nous ferons a partir 
de maintenant. 
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Ouverture d'une fenetre 

Bon : la SDL est initialisee et fermee correctement, maintenant. La prochaine etape, 
si vous le voulez bien, et je suis sur que vous le voulez bien, c'est l'ouverture d'une 
fenetre ! 

Pour commencer deja, assurez-vous d'avoir un main qui ressemble a ceci : 

int main(int argc, char *argv[]) 
{ 

if (SDL_Init(SDL_INIT_VIDEu) == -1) 

{ 

fprintf (stderr, "Erreur d' initialisation de la SDL"); 

exit(EXIT_FAILURE) ; 
} 

SDL_Quit() ; 

return EXIT_SUCCESS; 



Cela devrait etre le cas si vous avez bien suivi le debut du chapitre. Pour le moment 
done, on initialise juste la video (SDL_INIT_VIDE0), c'est tout ce qui nous interesse. 



3. Pour peu que vous programmiez correctement en utilisant les outils fournis, comme ici. 
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Choix du mode video 

La premiere chose a faire apres SDL_Init () , c'est indiquer le mode video que vous vou- 
lez utiliser, c'est-a-dire la resolution, le nombre de couleurs et quelques autres options. 

On va utiliser pour cela la fonction SDL_SetVideoMode () qui prend quatre parametres : 

- la largeur de la fenetre desiree (en pixels) ; 

- la hauteur de la fenetre desiree (en pixels) ; 

- le nombre de couleurs affichables (en bits / pixel) ; 

- des options (des flags). 

Pour la largeur et la hauteur de la fenetre, je crois que je ne vais pas vous faire l'affront 
de vous expliquer ce que c'est. Par contre, les deux parametres suivants sont plus 
interessants. 

- Le nombre de couleurs : c'est le nombre maximal de couleurs affichables dans 
votre fenetre. Si vous jouez aux jeux video, vous devriez avoir l'habitude de cela. 
Une valeur de 32 bits / pixel permet d'afficher des milliards de couleurs (c'est le 
maximum). C'est cette valeur que nous utiliserons le plus souvent car desormais 
tous les ordinateurs gerent les couleurs en 32 bits 4 . 

- Les options : comme pour SDL_Init on doit utiliser des flags pour definir des 
options. Voici les principaux flags que vous pouvez utiliser (et combiner avec le 
symbole I). 

- SDL_HWSURFACE : les donnees seront chargees dans la memoire video, c'est-a-dire 
dans la memoire de votre carte 3D. Avantage : cette memoire est plus rapide. 
Defaut : il y a en general moins d'espace dans cette memoire que dans l'autre 
(SDL_SWSURFACE). 

- SDL_SWSURFACE : les donnees seront chargees dans la memoire systeme (c'est-a- 
dire la RAM, a priori). Avantage : il y a beaucoup d'espace dans cette memoire. 
Defaut : c'est moins rapide et moins optimise. 

- SDL_RESIZABLE : la fenetre sera redimensionnable. Par defaut elle ne l'est pas. 

- SDL_NOFRAME : la fenetre n'aura pas de barre de titre ni de bordure. 

- SDL_FULLSCREEN : mode plein ecran. Dans ce mode, aucune fenetre n'est ouverte. 
Votre programme prendra toute la place a l'ecran, en changeant automatiquement 
la resolution de celui-ci au besoin. 

- SDL_DOUBLEBUF : mode double buffering. C'est une technique tres utilisee dans les 
jeux 2D, et qui permet de faire en sorte que les deplacements des objets a l'ecran 
soient fluides, sinon <ja scintille et c'est assez laid. Je vous expliquerai les details 
de cette technique tres interessante plus loin. 

Done, si je fais : 

| SDL_SetVideoMode(640, 480, 32, SDL_HWSURFACE) ; 

. . . cela ouvre une fenetre de taille 640 x 480 en 32 bits / pixel (milliards de couleurs) 
qui sera chargee en memoire video (c'est la plus rapide, on preferera utiliser celle-la). 



4. Sachez aussi que vous pouvez mettre des valeurs plus faibles comme 16 bits / pixel (65536 
couleurs), ou 8 bits / pixel (256 couleurs). Cela peut etre utile surtout si vous faites un programme 
pour un petit appareil genre PDA ou telephone portable. 
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Autre exemple, si je fais : 

| SDL_SetVideoMode(400, 300, 32, SDL_HWSURFACE I SDL_RESIZABLE I SDL_D0UBLEBUF) ; 

. . . cela ouvre une fenetre redimensionnable de taille initiate 400 x 300 (32 bits / pixel) 
en memoire video, avec le double buffering active. 

Voici un premier code source tres simple 5 que vous pouvez essayer : 

#include <stdlib.h> 
#include <stdio.h> 
#include <SDL/SDL.h> 

int main(int argc, char *argv[]) 
{ 

SDL_Init(SDL_INIT_VIDE0) ; 

SDL_SetVideoMode(640, 480, 32, SDL_HWSURFACE) ; 

SDL_Quit() ; 

return EXIT_SUCCESS; 



> [ Code web : 194049 ) 

Testez. Que se passe-t-il? La fenetre apparait et disparait a la vitesse de la lumiere. 
En effet, la fonction SDL_SetVideoMode est immediatement suivie de SDL_Quit, done 
tout s'arrete immediatement. 



Mettre en pause le programme 

H Comment faire en sorte que la fenetre se maintienne? 




II faut faire comme le font tous les programmes, que ce soit des jeux video ou autre : une 
boucle infinie. En effet, a l'aide d'une bete boucle infinie on empeche notre programme 
de s'arreter. Le probleme est que cette solution est trop efficace car du coup, il n'y a 
pas de moyen d' arret er le programme 6 . 

Voici un code qui fonctionne mais a ne pas tester, je vous le donne juste a titre 
explicatif : 



5. J'ai volontairement retire la gestion d'erreur pour rendre le code plus lisible et plus court, mais 
vous devriez dans un vrai programme prendre toutes les precautions necessaires et gerer les erreurs. 

6. A part un bon vieux CTRL + ALT + SUPPR a la rigueur mais e'est. . . brutal. 
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int main(int argc, char *argv[]) 
{ 

SDL_Init(SDL_INIT_VIDEO) ; 

SDL_SetVideoMode(640, 480, 32, SDL_HWSURFACE) ; 

while (1) ; 

SDL_Quit() ; 

return EXIT_SUCCESS; 



Vous reconnaissez le while (1); : c'est la boucle infinie. Comme 1 signifie « vrai » 
(rappelez-vous les booleens), la boucle est toujours vraie et tourne en rond indefmiment 
sans qu'il y ait moyen de l'arreter. Ce n'est done pas une tres bonne solution. 

Pour mettre en pause notre programme afin de pouvoir admirer notre belle fenetre 
sans faire de boucle interminable, on va utiliser une petite fonction a moi, la fonction 
pause () : 

void pause () 
{ 

int continuer = 1; 

SDL_Event event ; 

while (continuer) 
{ 

SDL_WaitEvent (ftevent) ; 
switch(event .type) 
{ 

case SDL_QUIT: 

continuer = 0; 
} 
} 



> ( Code web : 157722 ) 



Je ne vous explique pas le detail de cette fonction pour le moment. C'est volontaire, 
car cela fait appel a la gestion des evenements que je vous expliquerai seulement dans 
un prochain chapitre. Si je vous explique tout a la fois maintenant, vous risquez de 
tout melanger ! Faites done pour l'instant confiance a ma fonction de pause, nous ne 
tarderons pas a l'expliquer. 

Voici un code source complet et correct que vous pouvez (enfin !) tester : 

#include <stdlib.h> 
#include <stdio.h> 
#include <SDL/SDL.h> 
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void pause () ; 

int main(int argc, char *argv[]) 
{ 

SDL_Init(SDL_INIT_VIDEO) ; // Initialisation de la SDL 

SDL_SetVideoMode(640, 480, 32, SDL_HWSURFACE) ; // Ouverture de la fenetre 

pause () ; // Mise en pause du programme 

SDL_Quit(); // Arret de la SDL 

return EXIT_SUCCESS; // Fermeture du programme 



void pause () 
{ 

int continuer = 1 ; 

SDL_Event event ; 

while (continuer) 
{ 

SDL_WaitEvent (ftevent) ; 
switch(event . type) 
{ 

case SDL_QUIT: 

continuer = 0; 
} 
} 



[> Code web : 918671 



Vous remarquerez que j'ai mis le prototype de ma fonction pause () en haut pour tout 
vous presenter sur un seul fichier. Je fais appel a la fonction pause () qui fait une boucle 
infinie un peu plus intelligente que tout a l'heure. Cette boucle s'arretera en effet si 
vous cliquez sur la croix pour fermer la fenetre ! 

La fig. 21.1 vous donne une idee de ce a quoi devrait ressembler la fenetre que vous 
avez sous les yeux (ici, une fenetre 640 x 480). 

Pfiou ! Nous y sommes enfin arrives ! 

Si vous voulez, vous pouvez mettre le flag « redimensionnable » pour autoriser le 
redimensionnement de votre fenetre. Toutefois, dans la plupart des jeux on prefere 
avoir une fenetre de taille fixe (c'est plus simple a gerer!), nous garderons done notre 
fenetre fixe pour le moment. 
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Figure 21.1 - Une fenetre vide en 640 x 480 



A 



Attention au mode plein ecran (SDL_FULLSCREEN) et au mode sans bordure 
(SDL_N0FRAME). Comme il n'y a pas de barre de titre dans ces deux modes, 
vous ne pourrez pas fermer le programme et vous serez alors obliges d'utiliser 
la commande CTRL + ALT + SUPPR. Attendez d'apprendre a manipuler les 
evenements SDL (dans quelques chapitres) et vous pourrez alors coder un 
moyen de sortir de votre programme avec une technique un peu moins brutale 
que le CTRL + ALT + SUPPR. 



Changer le titre de la fenetre 

Pour le moment, notre fenetre a un titre par defaut : (SDL_app sur la fig. 21.1). Que 
diriez-vous de changer cela ? 

C'est extremement simple, il suffit d'utiliser la fonction SDL_WM_SetCaption. Cette 
fonction prend deux parametres. Le premier est le titre que vous voulez donner a la 
fenetre, le second est le titre que vous voulez donner a l'icone. 

Contrairement a ce qu'on pourrait croire, donner un titre a l'icone ne correspond pas 
a charger une icone qui s'afficherait dans la barre de titre en haut a gauche. Cela ne 
fonctionne pas partout 7 . Personnellement, j'envoie la valeur NULL a la fonction. Sachez 
qu'il est possible de changer l'icfine de la fenetre, mais nous verrons comment le faire 
dans le chapitre suivant seulement, car ce n'est pas encore de notre niveau. 

Voici done le meme main que tout a l'heure avec la fonction SDL_WM_SetCaption en 
plus : 



7. A ma connaissance, cela donne un resultat sous Gnome sous Linux. 
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int main(int argc, char *argv[]) 
{ 

SDL_Init(SDL_INIT_VIDEO) ; 

SDL_SetVideoMode(640, 480, 32, SDL_HWSURFACE) ; 
SDL_WM_SetCaption("Ma super fenetre SDL !", NULL); 

pause () ; 

SDL_Quit() ; 

return EXIT_SUCCESS; 



> [Code web : 121572^ 




O 



Vous aurez remarque que j'ai mis NULL pour le fameux second parametre 
peu utile. En C, il est obligatoire de renseigner tous les parametres meme si 
certains ne vous interessent pas, quitte a envoyer NULL comme je I'ai fait ici. 
Le C++ permet, lui, de ne pas renseigner certains parametres facultatifs lors 
des appels de fonctions. 



La fenetre a maintenant un titre (cf fig. 21.2). 




Figure 21.2 - Une fenetre avec un titre 
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Manipulation des surfaces 

Pour le moment nous avons une fenetre avec un fond noir. C'est la fenetre de base. Ce 
qu'on veut faire, c'est la remplir, c'est-a-dire « dessiner » dedans. 

La SDL, je vous l'ai dit dans le chapitre precedent, est une bibliotheque bas niveau. 
Cela veut dire qu'elle ne nous propose que des fonctions de base, tres simples. Et en 
effet, la seule forme que la SDL nous permet de dessiner, c'est le rectangle ! Tout ce que 
vous allez faire, c'est assembler des rectangles dans la fenetre. On appelle ces rectangles 
des surfaces. La surface est la brique de base de la SDL. 

II est bien sur possible de dessiner d'autres formes, comme des cercles, des 
triangles, etc. Mais pour le faire, il faudra ecrire nous-memes des fonctions, 
en dessinant pixel par pixel la forme, ou bien utiliser une bibliotheque sup- 
plemental avec la SDL. C'est un peu complique et de toute maniere, vous 
verrez que nous n'en aurons pas vraiment besoin dans la pratique. 
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Votre premiere surface : l'ecran 

Dans tout programme SDL, il y a au moins une surface que l'on appelle generalement 
ecran (ou screen en anglais). C'est une surface qui correspond a toute la fenetre, 
c'est-a-dire a toute la zone noire de la fenetre que vous voyez. 

Dans notre code source, chaque surface sera memorisee dans une variable de type 
SDL_Surf ace. Oui, c'est un type de variable cree par la SDL (une structure, en l'oc- 
currence) . 

Comme la premiere surface que nous devons creer est l'ecran, allons-y : 

| SDL .Surface *ecran = NULL; 

Vous remarquerez que je cree un pointeur. Pourquoi je fais <ja? Parce que c'est la SDL 
qui va allouer de l'espace en memoire pour notre surface. Une surface n'a en effet pas 
toujours la meme taille et la SDL est obligee de faire une allocation dynamique pour 
nous (ici, ca dependra de la taille de la fenetre que vous avez ouverte). 

Je ne vous l'ai pas dit tout a l'heure, mais la fonction SDL_SetVideoMode renvoie une 
valeur ! Elle renvoie un pointeur sur la surface de l'ecran qu'elle a creee en memoire 
pour nous. Parfait, on va done pouvoir recuperer ce pointeur dans ecran : 

| ecran = SDL_SetVideoMode(640, 480, 32, SDL_HWSURFACE) ; 

Notre pointeur peut maintenant valoir : 

- NULL : ecran vaut NULL si la SDL_SetVideoMode n'a pas reussi a charger le mode 
video demande. Cela arrive si vous demandez une trop grande resolution ou un trop 
grand nombre de couleurs que ne supporte pas votre ordinateur ; 
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- une autre valeur : si la valeur est differente de NULL, c'est que la SDL a pu allouer la 
surface en memoire, done que tout est bon ! 

II serait bien ici de gerer les erreurs, comme on a appris a le faire tout a l'heure 
pour l'initialisation de la SDL. Voici done notre main avec la gestion de l'erreur pour 
SDL_SetVideoMode : 

int main(int argc, char *argv[]) 
{ 

SDL_Surface *ecran = NULL; // Le pointeur qui va stocker la surface de 
«-> 1' ecran 

SDL_Init(SDL_INIT_VIDEO) ; 

ecran = SDL_SetVideoMode(640, 480, 32, SDL_HWSURFACE) ; // On tente d'ouvrir 
c — ¥ une fenetre 

if (ecran == NULL) // Si l'ouverture a echoue, on le note et on arrete 
{ 

fprintf (stderr, "Impossible de charger le mode video : */,s\n", 
<^-> SDL_GetError()) ; 

exit(EXIT_FAILURE) ; 
} 

SDL_WM_SetCaption("Ma super fenetre SDL !", NULL); 

pause () ; 

SDL_Quit() ; 

return EXIT_SUCCESS; 



D> ( Code web : 788134 ) 

Le message que nous laissera SDL_GetError() nous sera tres utile pour savoir ce qui 
n'a pas marche. 

Petite anecdote : une fois, je me suis trompe en voulant faire du plein ecran. 
Au lieu de demander une resolution de 1024 * 768, j'ai ecrit 10244 * 768. 
Je ne comprenais pas au depart pourquoi ca ne voulait pas charger, car je ne 
voyais pas le double 4 dans mon code (oui, je devais etre un peu fatigue). Un 
petit coup d'ceil au fichier stderr.txt qui contenait l'erreur et j'ai tout de 
suite compris que e'etait ma resolution qui avait ete rejetee (tiens, comme 
c'est curieux I). 
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Colorer une surface 

II n'y a pas 36 facons de remplir une surface. . . En fait, il y en a deux : 
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soit vous remplissez la surface avec une couleur unie ; 
soit vous remplissez la surface en chargeant une image. 



II est aussi possible de dessiner pixel par pixel dans la surface mais c'est assez 
complique, nous ne le verrons pas ici. 
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Nous allons dans un premier temps voir comment remplir une surface avec une couleur 
unie. Dans le chapitre suivant, nous apprendrons a charger une image. 

La fonction qui permet de colorer une surface avec une couleur unie s'appelle SDL_FillRect 
(FillRect = « remplir rectangle » en anglais). Elle prend trois parametres, dans l'ordre : 

- un pointeur sur la surface dans laquelle on doit dessiner (par exemple ecran) ; 

- la partie de la surface qui doit etre remplie. Si vous voulez remplir toute la surface 
(et c'est ce qu'on veut faire), envoyez NULL; 

- la couleur a utiliser pour remplir la surface. 

En resume : 

| SDL_FillRect (surface, NULL, couleur); 



La gestion des couleurs en SDL 

En SDL, une couleur est stockee dans un nombre de type Uint32. 

)\ Si c'est un nombre, pourquoi ne pas avoir utilise le type de variable int ou 
V long, tout simplement? 

La SDL est une bibliotheque multi-plates-formes. Or, comme vous le savez maintenant, 
la taille occupee par un int ou un long peut varier selon votre OS. Pour s'assurer que 
le nombre occupera toujours la meme taille en memoire, la SDL a done « invente » des 
types pour stocker des entiers qui ont la meme taille sur tous les systemes. II y a par 
exemple : 

- Uint32 : un entier de longueur 32 bits (soit 4 octets 8 ) ; 

- Uintl6 : un entier code sur 16 bits (2 octets) ; 

- Uint8 : un entier code sur 8 bits (1 octet). 

La SDL ne fait qu'un simple typedef qui changera selon l'OS que vous utilisez. Re- 
gardez de plus pres le fichier SDL_types.h si vous etes curieux. 

On ne va pas s'attarder la-dessus plus longtemps car les details de tout cela ne sont 
pas importants. Vous avez juste besoin de retenir que Uint32 est un type qui stocke 
un entier, comme un int. 




8. Je rappelle que 1 octet = 8 bits. 
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D'accord, mais comment je sais quel nombre je dois mettre pour utiliser la 
couleur verte, azur, gris fonce ou encore jaune pale a points roses avec des 
petites fleurs violettes 9 ? 

II existe une fonction qui sert a ca : SDL_MapRGB. Elle prend quatre parametres : 

- le format des couleurs. Ce format depend du nombre de bits / pixel que vous avez 
demande avec SDL_SetVideoMode. Vous pouvez le recuperer, il est stocke dans la 
sous-variable ecran->f ormat ; 

- la quantite de rouge de la couleur ; 

- la quantite de vert de la couleur ; 

- la quantite de bleu de la couleur. 

Certains d'entre vous ne le savent peut-etre pas, mais toute couleur sur un ordinateur 
est construite a partir de trois couleurs de base : le rouge, le vert et le bleu. Chaque 
quantite peut varier de (pas de couleur) a 255 (toute la couleur). Done, si on ecrit : 

| SDL_MapRGB(ecran->f ormat, 255, 0, 0) 

... on cree une couleur rouge. II n'y a pas de vert ni de bleu. 
Autre exemple, si on ecrit : 

| SDL_MapRGB(ecran->f ormat, 0, 0, 255) 

. . . cette fois, e'est une couleur bleue. 

| SDL_MapRGB(ecran->f ormat, 255, 255, 255) 

... la, il s'agit d'une couleur blanche (toutes les couleurs s'additionnent). Si vous voulez 
du noir, il faut done ecrire 0, 0, 0. 

H On ne peut que mettre du rouge, du vert, du bleu, du noir et du blanc? 




O 



Non, e'est a vous de combiner intelligemment les quantites de couleurs. Pour vous 
aider, ouvrez par exemple le logiciel Paint. Allez dans le menu Couleurs / Modifier 
les couleurs. Cliquez sur le bouton Definir les couleurs personnalisees. La, 
choisissez la couleur qui vous interesse (fig. 21.3). 

Les composantes de la couleur sont afRchees en bas a droite. Ici, j'ai selectionne un 
bleu-vert. Comme l'indique la fenetre, il se cree a l'aide de 17 de rouge, 206 de vert et 
112 de bleu. 



9. Bien entendu, cette derniere couleur n'existe pas. 
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Modification des couleurs 



Couleurs de base : 

■ rnn 

HI — ■■■ 
■ ■■ 



Couleurs personnalisees : 

rrrrrrrr 
rrrrrrrr 



J CouleurlUnie Lum R05I 




Figure 21.3 - Selection d'une couleur et de ses composantes 

Coloration de l'ecran 

La fonction SDL_MapRGB renvoie un Uint32 qui correspond a la couleur demandee. On 
peut done creer une variable bleuVert qui contiendra le code de la couleur bleu-vert : 

|Uint32 bleuVert = SDL_MapRGB(ecran->f ormat , 17, 206, 112); 

Toutefois, ce n'est pas toujours la peine de passer par une variable pour stocker la 
couleur (a moins que vous en ayez besoin tres souvent dans votre programme). Vous 
pouvez tout simplement envoyer directement la couleur donnee par SDL_MapRGB a 
SDL_FillRect. 

Si on veut remplir notre ecran de bleu-vert, on peut done ecrire : 

| SDL_FillRect(ecran, NULL, SDL_MapRGB(ecran->f ormat , 17, 206, 112)); 

On combine ici deux fonctions, mais comme vous devriez maintenant le savoir, <ja ne 
pose aucun probleme au langage C. 

Mise a jour de l'ecran 

Nous y sommes presque. Toutefois il manque encore une petite chose : demander la 
mise a jour de l'ecran. En effet, l'instruction SDL_FillRect colorie bien l'ecran mais 
cela ne se fait que dans la memoire. II faut ensuite demander a l'ordinateur de mettre 
a jour l'ecran avec les nouvelles donnees. 

Pour cela, on va utiliser la fonction SDL_Flip, dont nous reparlerons plus longuement 
plus loin dans le cours. Cette fonction prend un parametre : l'ecran. 



I SDL_Flip (ecran) ; /* Mise a jour de l'ecran */ 



321 



CHAPITRE 21. CREATION D'UNE FENETRE ET DE SURFACES 

On resume ! 

Voici une fonction main() qui cree une fenetre avec un fond bleu- vert : 

int main(int argc, char *argv[]) 
{ 

SDL_Surface *ecran = NULL; 

SDL_Init(SDL_INIT_VIDEO) ; 

ecran = SDL_SetVideoMode(640, 480, 32, SDL_HWSURFACE) ; 
SDL_WM_SetCaption("Ma super fenetre SDL !", NULL); 

// Coloration de la surface ecran en bleu-vert 

SDL_FillRect (ecran, NULL, SDL_MapRGB(ecran->f ormat , 17, 206, 112)); 

SDL_Flip (ecran) ; /* Mise a jour de l'ecran avec sa nouvelle couleur */ 

pause () ; 

SDL_Quit() ; 

return EXIT_SUCCESS; 



> ( Code web : 266841 ) 

Le resultat est presente sur la fig. 21.4. 




Figure 21.4 - La fenetre est remplie d'un fond bleu-vert 
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Dessiner une nouvelle surface a l'ecran 

C'est bien, mais ne nous arretons pas en si bon chemin. Pour le moment on n'a qu'une 
seule surface, c'est-a-dire l'ecran. On aimerait pouvoir y dessiner, c'est-a-dire « coller » 
des surfaces avec une autre couleur par-dessus. 

Pour commencer, nous allons avoir besoin de creer une variable de type SDL_Surf ace 
pour cette nouvelle surface : 

| SDL .Surface ^rectangle = NULL; 

Nous devons ensuite demander a la SDL de nous allouer de l'espace en memoire pour 
cette nouvelle surface. Pour l'ecran, nous avons utilise SDL_SetVideoMode. Toutefois, 
cette fonction ne marche que pour l'ecran (la surface globale), on ne va pas creer une 
fenetre differente pour chaque rectangle que l'on veut dessiner ! 

II existe done une autre fonction pour creer une surface : SDL_CreateRGBSurf ace. C'est 
celle que nous utiliserons a chaque fois que nous voudrons creer une surface unie comme 
ici. 

Cette fonction prend. . . beaucoup de parametres (huit!). D'ailleurs, peu d'entre eux 
nous interessent pour l'instant, je vais done eviter de vous detainer ceux qui ne nous 
serviront pas de suite. Comme en C nous sommes obliges d'indiquer tous les parametres, 
nous enverrons la valeur quand le parametre ne nous interesse pas. 

Regardons de plus pres les quatre premiers parametres, les plus interessants (ils de- 
vraient vous rappeler la creation de l'ecran). 

- Une liste de flags (des options). Vous avez le choix entre : 

- SDL_HWSURFACE : la surface sera chargee en memoire video. II y a moins d'espace 
dans cette memoire que dans la memoire systeme 10 , mais cette memoire est plus 
optimisee et acceleree ; 

- SDL_SWSURFACE : la surface sera chargee en memoire systeme ou il y a beaucoup 
de place, mais cela obligera votre processeur a faire plus de calculs. Si vous aviez 
charge la surface en memoire video, c'est la carte 3D qui aurait fait la plupart des 
calculs. 

- La largeur de la surface (en pixels). 

- La hauteur de la surface (en pixels). 

- Le nombre de couleurs (en bits / pixel). 

Voici done comment on alloue notre nouvelle surface en memoire : 

| rectangle = SDL_CreateRGBSurf ace(SDL_HWSURFACE, 220, 180, 32, 0, 0, 0, 0); 

Les quatre derniers parametres sont mis a 0, comme je vous l'ai dit, car ils ne nous 
interessent pas. 

Comme notre surface a ete allouee manuellement, il faudra penser a la liberer de la 
memoire avec la fonction SDL_FreeSurf ace(), a utiliser juste avant SDL_Quit() : 



10. Quoique, avec les cartes 3D qu'on sort de nos jours, il y a de quoi se poser des questions. . . 
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SDL_FreeSurf ace (rectangle) ; 
SDL_Quit() ; 



La surface ecran n'a pas besoin d'etre liberee avec SDL_FreeSurf ace() , 
cela est fait automatiquement lors de SDL_Quit(). 




a 



On peut maintenant colorer notre nouvelle surface en la remplissant par exemple de 
blanc : 

| SDL_FillRect (rectangle, NULL, SDL_MapRGB(ecran->f ormat , 255, 255, 255)); 

Coller la surface a l'ecran 

Allez, c'est presque fini, courage! Notre surface est prete, mais si vous testez le pro- 
gramme vous verrez qu'elle ne s'affichera pas ! En effet, la SDL n'afHche a l'ecran que 
la surface ecran. Pour que l'on puisse voir notre nouvelle surface, il va falloir blit- 
ter la surface, c'est-a-dire la coller sur l'ecran. On utilisera pour cela la fonction 
SDL_BlitSurface. 

Cette fonction attend : 

- la surface a coller (ici, ce sera rectangle) ; 

- une information sur la partie de la surface a coller (facultative). Ca ne nous interesse 
pas car on veut coller toute la surface, done on enverra NULL ; 

- la surface sur laquelle on doit coller, c'est-a-dire ecran dans notre cas ; 

- un pointeur sur une variable contenant des coordonnees. Ces coordonnees indiquent 
ou devra etre collee notre surface sur l'ecran, c'est-a-dire sa position. 

Pour indiquer les coordonnees, on doit utiliser une variable de type SDL_Rect. C'est 
une structure qui contient plusieurs sous- variables, dont deux qui nous interessent ici : 

- x : l'abscisse ; 

- y : l'ordonnee. 

II faut savoir que le point de coordonnees (0, 0) est situe tout en haut a gauche. En 
bas a droite, le point a les coordonnees (640, 480) si vous avez ouvert une fenetre de 
taille 640 x 480 comme moi. 

Aidez-vous du schema de la fig. 21.5 pour vous situer. 

Si vous avez deja fait des maths une fois dans votre vie, vous ne devriez pas etre trop 
perturbes. Creons done une variable position. On va mettre x et y a pour coller la 
surface en haut a gauche de l'ecran : 

SDL_Rect position; 

position. x = 0; 
position. y = 0; 
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10.01 



(0. 480) 



^ 



{640. 0} 



<640. 4S0) 



Figure 21.5 - Coordonnees sur la fenetre 

Maintenant qu'on a notre variable position, on peut blitter notre rectangle sur l'ecran : 

I SDL_BlitSurf ace (rectangle, NULL, ecran, &position) ; 

Remarquez le symbole &, car il faut envoyer l'adresse de notre variable position. 



Resume du code source 

Je crois qu'un petit code pour resumer tout <ja ne sera pas superflu ! 

int main(int argc, char *argv[]) 
{ 

SDL_Surface *ecran = NULL, *rectangle = NULL; 

SDL_Rect position; 

SDL_Init(SDL_INIT_VIDE0) ; 

ecran = SDL_SetVideoMode(640, 480, 32, SDL_HWSURFACE) ; 

// Allocation de la surface 

rectangle = SDL_CreateRGBSurface(SDL_HWSURFACE, 220, 180, 32, 0, 0, 0, 0) ; 

SDL_WM_SetCaption("Ma super fenetre SDL !", NULL); 

SDL_FillRect (ecran, NULL, SDL_MapRGB (ecran- >format, 17, 206, 112)); 

position. x = 0; // Les coordonnees de la surface seront (0, 0) 

position. y = 0; 

// Remplissage de la surface avec du blanc 
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SDL_FillRect (rectangle, NULL, SDL_MapRGB(ecran->f ormat , 255, 255, 255)); 
SDL_BlitSurf ace (rectangle, NULL, ecran, ^position) ; // Collage de la surface 
■> sur 1 'ecran 

SDL_Flip (ecran) ; // Mise a jour de l'ecran 

pause () ; 

SDL_FreeSurf ace (rectangle) ; // Liberation de la surface 
SDL_Quit() ; 

return EXIT_SUCCESS; 



t> ( Code web : 687265 ) 

Et voila le travail (fig. 21.6) ! 




Figure 21.6 - Une surface blanche en haut a gauche de la fenetre 



Centrer la surface a l'ecran 

On sait afficher la surface en haut a gauche. II serait aussi facile de la placer en bas a 
droite. Les coordonnees seraient (640 - 220, 480 - 180), car il faut retrancher la taille 
de notre rectangle pour qu'il s'affiche entierement. 

Mais. . . comment faire pour centrer le rectangle blanc ? Si vous reflechissez bien deux 
secondes, c'est mathematique 11 . 



11. C'est la qu'on comprend l'interet des maths et de la geometrie ! Et encore, tout ceci est d'un 
niveau tres simple ici. 
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position. x 
position. y 



(640 / 2) 
(480 / 2) 



(220 / 2); 
(180 / 2); 



L'abscisse du rectangle sera la moitie de la largeur de l'ecran (640 / 2). Mais, en plus 
de ga, il faut retrancher la moitie de la largeur du rectangle (220 / 2), car sinon ga 
ne sera pas parfaitement centre (essayez de ne pas le faire, vous verrez ce que je veux 
dire). C'est la meme chose pour l'ordonnee avec la hauteur de l'ecran et du rectangle. 

Resultat : la surface blanche est parfaitement centree (fig. 21.7). 




Figure 21.7 - Une surface blanche au centre de la fenetre 



Exercice : creer un degrade 

On va finir le chapitre par un petit exercice (corrige) suivi d'une serie d'autres exercices 
(non corriges pour vous forcer a travailler !). 

L'exercice corrige n'est vraiment pas difficile : on veut creer un degrade vertical allant 
du noir au blanc. Vous allez devoir creer 255 surfaces de 1 pixel de hauteur. Chacune 
aura une couleur differente, de plus en plus noire. 

Void ce que vous devez arriver a obtenir au final, une image similaire a la fig. 21.8. 

C'est mignon, non? Et le pire c'est qu'il suffit de quelques petites boucles seulement 
pour y arriver. 

Pour faire ga, on va devoir creer 256 surfaces (256 lignes) ayant les composantes rouge- 
vert-bleu suivantes : 



(0, 0, 0) // Noir 

(1, 1, 1) // Gris tres tres proche du noir 
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Figure 21.8 - Degrade du noir au blanc 

(2, 2, 2) // Gris tres proche du noir 

(128, 128, 128) // Gris moyen (a 50 */,) 

(253, 253, 253) // Gris tres proche du blanc 
(254, 254, 254) // Gris tres tres proche du blanc 
(255, 255, 255) // Blanc 

Tout le monde devrait avoir vu venir une boucle pour faire <ja (on ne va pas faire 256 
copier-coller !). Vous allez devoir creer un tableau de type SDL_Surf ace* de 256 cases 
pour stocker chacune des lignes. 

Allez au boulot, je vous donne 5 minutes ! 



Correction ! 

D'abord, il fallait creer notre tableau de 256 SDL_Surf ace*. On l'initialisc a NULL : 

| SDL_Surf ace *lignes[256] = {NULL}; 

On cree aussi une variable i dont on aura besoin pour nos for. 

On change aussi la hauteur de la fenetre pour qu'elle soit plus adaptee dans notre cas. 
On lui donne done 256 pixels de hauteur, pour chacune des 256 lignes a afficher. 

Ensuite, on fait un for pour allouer une a une chacune des 256 surfaces. Le tableau 
recevra 256 pointeurs vers chacune des surfaces creees : 

for (i = ; i <= 255 ; i++) 

lignes[i] = SDL_CreateRGBSurf ace(SDL_HWSURFACE, 640, 1, 32, 0, 0, 0, 0); 

Ensuite, on remplit et on blitte chacune de ces surfaces une par une. 
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for (i = 

{ 

position. x 
position. y 



i <= 255 



i++) 



0; // Les lignes sont a gauche (abscisse de 0) 

i; //La position verticale depend du numero de la ligne 



SDL_FillRect (lignes [i] , NULL, SDL_MapRGB(ecran->f ormat , i, i, i)); // Dessin 
SDL_BlitSurf ace (lignes [i] , NULL, ecran, imposition); // Collage 



Notez que j'utilise la meme variable position tout le temps. Pas besom d'en creer 256 
en effet, car la variable ne sert que pour etre envoyee a SDL_BlitSurf ace. On peut 
done la reutiliser sans probleme. Chaque fois, je mets a jour l'ordonnee (y) pour blitter 
la ligne a la bonne hauteur. La couleur a chaque passage dans la boucle depend de i 
(ce sera 0, 0, la premiere fois, et 255, 255, 255 la derniere fois). 




Mais pourquoi x est toujours a 0? Comment se fait-il que toute la ligne soit 
remplie si x est tout le temps a 0? 



Notre variable position indique a quel endroit est place le coin en haut a gauche 
de notre surface (ici, notre ligne). Elle n'indique pas la largeur de la surface, juste sa 
position sur l'ecran. Comme toutes nos lignes commencent a gauche de la fenetre (le 
plus a gauche possible), on met une abscisse de 0. Essayez de mettre une abscisse de 
50 pour voir ce que qa fait : toutes les lignes seront decalees vers la droite. Comme la 
surface fait 640 pixels de largeur, la SDL dessine 640 pixels vers la droite (de la meme 
couleur) en partant des coordonnees indiquees dans la variable position. 

Sur le schema de la fig. 21.9, je vous montre les coordonnees du point en haut a gauche 
de l'ecran (position de la premiere ligne) et celui du point en bas a droite de l'ecran 
(position de la derniere ligne). 




Figure 21.9 - Coordonnees sur la fenetre de degrade 

Comme vous le voyez, de haut en bas l'abscisse ne change pas (x reste egal a tout le 
long). C'est seulement y qui change pour chaque nouvelle ligne, d'oii le position. y = 
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i;- 

Enfin, il ne faut pas oublier de liberer la memoire pour chacune des 256 surfaces creees, 
le tout a l'aide d'une petite boucle bien entendu. 

for (i = ; i <= 255 ; i++) // N'oubliez pas de liberer les 256 surfaces 
SDL_FreeSurf ace(lignes [i] ) ; 



Resume du main 

Voici done la fonction main au complet : 

int main(int argc, char *argv[]) 
{ 

SDL_Surface *ecran = NULL, *lignes [256] = {NULL}; 

SDL_Rect position; 

int i = ; 

SDL_Init(SDL_INIT_VIDEO) ; 

ecran = SDL_SetVideoMode(640, 256, 32, SDL_HWSURFACE) ; 

for (i = ; i <= 255 ; i++) 

lignes[i] = SDL_CreateRGBSurface(SDL_HWSURFACE, 640, 1, 32, 0, 0, 0, 0) ; 

SDL_WM_SetCaption("Mon degrade en SDL !", NULL); 

SDL_FillRect (ecran, NULL, SDL_MapRGB(ecran->f ormat , 0, 0, 0)); 

for (i = ; i <= 255 ; i++) 

{ 

position. x = 0; // Les lignes sont a gauche (abscisse de 0) 
position. y = i; //La position verticale depend du numero de la ligne 
SDL_FillRect (lignes [i] , NULL, SDL_MapRGB(ecran->f ormat , i, i, i) ) ; 
SDL_BlitSurf ace (lignes [i] , NULL, ecran, ftposition) ; 

} 

SDL_Flip (ecran) ; 
pause () ; 

for (i = ; i <= 255 ; i++) // N'oubliez pas de liberer les 256 surfaces 

SDL_FreeSurf ace (lignes [i] ) ; 
SDL_Quit() ; 

return EXIT_SUCCESS; 



> ( Code web : 263960 ) 
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« Je veux des exercices pour m'entrainer ! » 

Pas de probleme, generateur d'exercices active ! 

- Creez le degrade inverse, du blanc au noir. Cela ne devrait pas etre trop difficile pour 
commencer ! 

- Vous pouvez aussi faire un double degrade, en allant du noir au blanc comme on a 
fait ici, puis du blanc au noir (la fenetre fera alors le double de hauteur). 

- Guere plus difficile, vous pouvez aussi vous entrainer a faire un degrade horizontal 
au lieu d'un degrade vertical. 

- Faites des degrades en utilisant d'autres couleurs que le blanc et le noir. Essayez 
pour commencer du rouge au noir, du vert au noir et du bleu au noir, puis du rouge 
au blanc, etc. 



En resume 

- La SDL doit etre chargee avec SDL_Init au debut du programme et dechargee avec 
SDL_Quit a la fin. 

- Les flags sont des constantes que l'on peut additionner entre elles avec le symbole 
« I ». Elles jouent le role d'options. 

- La SDL vous fait manipuler des surfaces qui ont la forme de rectangles avec le type 
SDL_Surf ace. Le dessin sur la fenetre se fait a l'aide de ces surfaces. 

- II y a toujours au moins une surface qui prend toute la fenetre, que l'on appelle en 
general ecran. 

- Le remplissage d'une surface se fait avec SDL_FillRect et le collage sur l'ecran a 
l'aide de SDL_BlitSurf ace. 

- Les couleurs sont definies a l'aide d'un melange de rouge, de vert et de bleu. 
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Chapitre 



22 



Afficher des images 



Difficulty : M 

ous venons d'apprendre a charger la SDL, a ouvrir une fenetre et gerer des surfaces. 
C'est vraiment la base de ce qu'il faut connaTtre sur cette bibliotheque. Cependant, 
pour le moment nous ne pouvons creer que des surfaces unies, c'est-a-dire ayant la 
meme couleur, ce qui est un peu monotone. 

Dans ce chapitre, nous allons apprendre a charger des images dans des surfaces, que ce 
soit des BMP, des PNG, des GIF ou des JPG. La manipulation d'images est souvent tres 
motivante car c'est en assemblant ces images (aussi appelees « sprites ») que Ion fabrique 
les premieres briques d'un jeu video. 




i 
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Charger une image BMP 

La SDL est une bibliotheque tres simple. Elle ne propose a la base que le chargement 
d'images de type « bitmap » (extension .bmp). Ne paniquez pas pour autant, car grace 
a une extension de la SDL (la bibliotheque SDL_Image), nous verrons qu'il est possible 
de charger de nombreux autres types. 

Pour commencer, nous allons nous contenter de ce que la SDL offre a la base. Nous 
allons done etudier le chargement de BMP. 



Le format BMP 

Un BMP (abreviation de « Bitmap ») est un format d'image. Les images que vous 
voyez sur votre ordinateur sont stockees dans des fichiers. II existe plusieurs formats 
d'images, e'est-a-dire plusieurs fagons de coder l'image dans un fichier. Selon le format, 
l'image prend plus ou moins d'espace disque et se trouve etre de plus ou moins bonne 
qualite. 

Le Bitmap est un format non compresse (contrairement aux JPG, PNG, GIF, etc.). 
Concretement, cela signifie les choses suivantes : 

- le fichier est tres rapide a lire, contrairement aux formats compresses qui doivent 
etre decompresses, ce qui prend un peu plus de temps ; 

- la qualite de l'image est parfaite. Certains formats compresses l deteriorent la qualite 
de l'image, ce n'est pas le cas du BMP ; 

- mais le fichier est aussi bien plus gros puisqu'il n'est pas compresse ! 

II a done des qualites et des defauts. Pour la SDL, l'avantage e'est que ce type de fichier 
est simple et rapide a lire. Si vous avez souvent besoin de charger des images au cours 
de l'execution de votre programme, il vaut mieux utiliser des BMP : certes le fichier 
est plus gros, mais il se chargera plus vite qu'un GIF par exemple. Cela peut se reveler 
utile si votre programme doit charger de tres nombreuses images en peu de temps. 

Charger un Bitmap 

Telechargement du pack d'images 

Nous allons travailler avec plusieurs images dans ce chapitre. Si vous voulez faire les 
tests en meme temps que vous lisez (et vous devriez!), je vous recommande de tele- 
charger un pack qui contient toutes les images dont on va avoir besoin. 



> 



Code web : 864175 



Bien entendu, vous pouvez utiliser vos propres images. II faudra en revanche adapter 
la taille de votre fenetre a celles-ci. 

Placez toutes les images dans le dossier de votre projet. Nous allons commencer par 



1. Je pense au JPG plus particulierement, car les PNG et GIF n'alterent pas l'image. 
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travailler avec le fichier lac_en_montagne.bmp 2 . 

Charger l'image dans une surface 

Nous allons utiliser une fonction qui va charger l'image BMP et la mettre dans une 
surface. Cette fonction a pour nom SDL_LoadBMP. Vous allez voir a quel point c'est 
simple : 

I maSurf ace = SDL_LoadBMPCimage.bmp"); 

La fonction SDL_LoadBMP remplace deux fonctions que vous connaissez : 

- SDL_CreateRGBSurf ace : elle se chargeait d'allouer de la memoire pour stocker une 
surface de la taille demandee (equivalent au malloc) ; 

- SDL_FillRect : elle remplissait la structure d'une couleur unie. 

Pourquoi est-ce que ca remplace ces deux fonctions? C'est tres simple : 

- la taille a allouer en memoire pour la surface depend de la taille de l'image : si l'image 
a une taille de 250 x 300, alors votre surface aura une taille de 250 x 300 ; 

- d'autre part, votre surface sera remplie pixel par pixel par le contenu de votre image 
BMP. 

Codons sans plus tarder : 

int main(int argc, char *argv[]) 
{ 

SDL_Surface *ecran = NULL, *imageDeFond = NULL; 

SDL_Rect positionFond; 

positionFond.x = 0; 
positionFond. y = 0; 

SDL_Init(SDL_INIT_VIDE0) ; 

ecran = SDL_SetVideoMode(800, 600, 32, SDL_HWSURFACE) ; 
SDL_WM_SetCaption("Chargement d'images en SDL", NULL); 

/* Chargement d'une image Bitmap dans une surface */ 

imageDeFond = SDL_LoadBMPClac_en_montagne.bmp"); 

/* On blitte par-dessus 1 'ecran */ 

SDL_BlitSurf ace (imageDeFond, NULL, ecran, ftpositionFond) ; 

SDL_Flip (ecran) ; 
pause () ; 

SDL_FreeSurf ace (imageDeFond) ; /* On libere la surface */ 



2. C'est une scene 3D d'exemple tiree de l'excellent logiciel de modelisation de paysages Vue d'Esprit 
4, qui n'est aujourd'hui plus commercialise. Depuis, le logiciel a ete renomme en « Vue » et a beaucoup 
evolue. Si vous voulez en savoir plus, rendez-vous sur e-onsoftware .com. 
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SDL_C)uit() ; 



return EXIT_SUCCESS; 



> [Code web : 312775) 

J'ai done cree un pointeur vers une surface (imageDeFond) ainsi que les coordonnees 
correspondantes (positionFond). La surface est creee en memoire et remplie par la 
fonction SDL_LoadBMP. On la blitte ensuite sur la surface ecran et e'est tout ! Admirez 
le resultat sur la fig. 22.1. 




Figure 22.1 - Une image BMP chargee dans la fenetre 
Comme vous voyez ce n'etait pas bien difficile ! 

Associer une icone a son application 

Maintenant que nous savons charger des images, nous pouvons decouvrir comment 
associer une icone a notre programme. L'icone sera affichee en haut a gauche de la 
fenetre (ainsi que dans la barre des taches). Pour le moment nous avons une icone par 
defaut. 




<? 



Mais, les icones des programmes ne sont-elles pas des .ico, normalement? 
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Non, pas forcement ! D'ailleurs les . ico n'existent que sous Windows. La SDL reconcilie 
tout le monde en utilisant un systeme bien a elle : une surface ! Eh oui, l'icone d'un 
programme SDL n'est rien d'autre qu'une simple surface. 



A 



Votre icone doit normalement etre de taille 16 x 16 pixels. Toutefois, sous 
Windows il faut que l'icone soit de taille 32 x 32 pixels, sinon elle sera de- 
formee. Ne vous en faites pas, la SDL « reduira » les dimensions de I'image 
pour quelle rentre dans 16 x 16 pixels. 



Pour ajouter l'icone a la fenetre, on utilise la fonction SDL_WM_SetIcon. Cette fonction 
prend deux parametres : la surface qui contient I'image a affkher ainsi que des infor- 
mations sur la transparence (NULL si on ne veut pas de transparence) . La gestion de la 
transparence d'une icone est un peu compliquee (il faut preciser un a un quels sont les 
pixels transparents), nous ne l'etudierons done pas. 

On va combiner deux fonctions en une : 

| SDL_WM_SetIcon(SDL_LoadBMP("sdl_icone.bmp") , NULL) ; 

L'image est chargee en memoire par SDL_LoadBMP et l'adresse de la surface est direc- 
tement envoyee a SDL_WM_SetIcon. 



o 



La fonction SDL_WM_SetIcon doit etre appelee avant que la fenetre ne soit 
ouverte, e'est-a-dire qu'elle doit se trouver avant SDL_SetVideoMode dans 
votre code source. 



Voici le code source complet. Vous noterez que j'ai simplement ajoute le SDL_WM_SetIcon 
par rapport au code precedent : 

int main(int argc, char *argv[]) 
{ 

SDL_Surface *ecran = NULL, *imageDeFond = NULL; 

SDL_Rect positionFond; 

positionFond.x = 0; 
positionFond. y = 0; 

SDL_Init(SDL_INIT_VIDEO) ; 

/* Chargement de l'icone AVANT SDL_SetVideoMode */ 
SDL_WM_SetIcon(SDL_LoadBMP("sdl_icone.bmp") , NULL) ; 

ecran = SDL_SetVideoMode(800, 600, 32, SDL_HWSURFACE) ; 
SDL_WM_SetCaption( "Chargement d'images en SDL", NULL); 

imageDeFond = SDL_LoadBMPClac_en_montagne.bmp"); 
SDL_BlitSurf ace(imageDeFond, NULL, ecran, ftpositionFond) ; 
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SDL_Flip(ecran) ; 
pause () ; 

SDL_FreeSurf ace(imageDeFond) ; 
SDL_Quit() ; 

return EXIT_SUCCESS; 
} 

Resultat, l'icone est chargee et affichee sur la fenetre (fig. 22.2). 



*"• '••'■""■ J " 



Figure 22.2 - Une icone associee au programme 



Gestion de la transparence 

Le probleme de la transparence 

Nous avons tout a l'heure charge une image bitmap dans notre fenetre. Supposons que 
l'on veuille blitter une image par-dessus. Qa vous arrivera tres frequemment car dans 
un jeu, en general, le personnage que l'on deplace est un Bitmap et il se deplace sur 
une image de fond. 

On va blitter l'image de Zozor 3 sur la scene : 

int main(int argc, char *argv[]) 
{ 

SDL_Surface *ecran = NULL, *imageDeFond = NULL, *zozor = NULL; 

SDL_Rect positionFond, positionZozor; 

positionFond.x = 0; 
positionFond. y = 0; 
positionZozor .x = 500; 
positionZozor .y = 260; 

SDL_Init(SDL_INIT_VIDE0) ; 

SDL_WM_SetIcon(SDL_LoadBMP("sdl_icone.bmp") , NULL) ; 

ecran = SDL_SetVideoMode(800, 600, 32, SDL_HWSURFACE) ; 
SDL_WM_SetCaption("Chargement d'images en SDL", NULL); 

imageDeFond = SDL_LoadBMPClac_en_montagne.bmp"); 
SDL_BlitSurf ace(imageDeFond, NULL, ecran, ftpositionFond) ; 



3. II s'agit de la bonne vieille mascotte du Site du Zero pour ceux qui ne le connaitraient pas. 
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/* Chargement et blittage de Zozor sur la scene */ 

zozor = SDL_LoadBMP ( "zozor. bmp" ) ; 

SDL_BlitSurf ace (zozor, NULL, ecran, ftpositionZozor) ; 

SDL_Flip(ecran) ; 
pause () ; 

SDL_FreeSurf ace(imageDeFond) ; 
SDL_FreeSurf ace (zozor) ; 
SDL_Quit() ; 

return EXIT_SUCCESS; 



On a juste rajoute une surface pour y stocker Zozor, que l'on blitte ensuite a un endroit 
sur la scene (fig. 22.3). 




Figure 22.3 - Zozor blitte par-dessus l'image de fond 



C'est plutot laid, non? 




<? 



Je sais pourquoi, c'est parce que tu as mis un fond bleu tout moche sur 
l'image de Zozor ! 
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Parce que vous croyez qu'avec un fond noir ou un fond marron derriere Zozor, ga 
aurait ete plus joli ? Eh bien non, le probleme ici c'est que notre image est forcement 
rectangulaire, done si on la colle sur la scene on voit son fond, ce qui ne rend pas tres 
bien. 

Heureusement, la SDL gere la transparence ! 

Rendre une image transparente 

Etape 1 : preparer l'image 

Pour commencer, il faut preparer l'image que vous voulez blitter sur la scene. Le format 
BMP ne gere pas la transparence, contrairement aux GIF et PNG. II va done falloir 
utiliser une astuce. 

II faut mettre la meme couleur de fond sur toute l'image. Celle-ci sera rendue trans- 
parente par la SDL au moment du blit. Observez a quoi ressemble mon zozor.bmp de 
plus pres (fig. 22.4). 




Figure 22.4 - L'image zozor.bmp a un fond bleu 

Le fond bleu derriere est done volontaire. Notez que j'ai choisi le bleu au hasard, j'aurais 
tres bien pu mettre un fond vert ou rouge par exemple. Ce qui compte, c'est que cette 
couleur soit unique et unie. J'ai choisi le bleu parce qu'il n'y en avait pas dans l'image 
de Zozor. Si j'avais choisi le vert, j'aurais pris le risque que l'herbe que machouille Zozor 
(en bas a gauche de l'image) soit rendue transparente. 

A vous done de vous debrouiller avec votre logiciel de dessin (Paint, Photoshop, The 
Gimp, chacun ses gouts) pour donner un fond uni a votre image. 

Etape 2 : indiquer la couleur transparente 

Pour indiquer a la SDL la couleur qui doit etre rendue transparente, vous devez utiliser 
la fonction SDL_SetColorKey. Cette fonction doit etre appelee avant de blitter l'image. 
Voici comment je m'en sers pour rendre le bleu derriere Zozor transparent : 

| SDL_SetColorKey (zozor, SDL_SRCCOLORKEY, SDL_MapRGB(zozor->f ormat , 0, 0, 255)); 

II y a trois parametres : 

- la surface qui doit etre rendue transparente (ici, c'est zozor) ; 

- une liste de flags : utilisez SDL_SRCC0L0RKEY pour activer la transparence, pour la 
desactiver ; 
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- indiquez ensuite la couleur qui doit etre rendue transparente. J'ai utilise SDL_MapRGB 
pour creer la couleur au format nombre (Uint32) comme on l'a deja fait par le passe. 
Comme vous le voyez, c'est le bleu pur (0, 0, 255) que je rends transparent. 

En resume, on charge d'abord l'image avec SDL_LoadBMP, on indique la couleur trans- 
parente avec SDL_SetColorKey, puis on peut blitter avec SDL_BlitSurf ace : 



/* On charge l'image : */ 

zozor = SDL_LoadBMPCzozor.bmp"); 

/* On rend le bleu derriere Zozor transparent : */ 

SDL_SetColorKey(zozor, SDL_SRCC0L0RKEY, SDL_MapRGB(zozor->f ormat , 0, 0, 255)); 

/* On blitte l'image maintenant transparente sur le fond : */ 

SDL_BlitSurf ace (zozor , NULL, ecran, ftpositionZozor) ; 



Resultat : Zozor est parfaitement integre a la scene (fig. 22.5) ! 




Figure 22.5 - Zozor transparent sur l'image de fond 

Voila LA technique de base que vous reutiliserez tout le temps dans vos futurs pro- 
grammes. Apprenez a bien manier la transparence car c'est fondamental pour realiser 
un jeu un minimum realiste. 

La transparence Alpha 

C'est un autre type de transparence. Jusqu'ici, on se contentait de definir UNE couleur 
de transparence (par exemple le bleu). Cette couleur n'apparaissait pas une fois l'image 
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blittee. 

La transparence Alpha correspond a tout autre chose. Elle permet de realiser un « me- 
lange » entre une image et le fond. C'est une sorte de fondu. 

La transparence Alpha d'une surface peut etre activee par la fonction SDL_SetAlpha : 
| SDL_SetAlpha(zozor, SDL_SRCALPHA, 128); 

II y a la encore trois parametres : 

- la surface en question (zozor) ; 

- une liste de flags : mettez SDL_SRCALPHA pour activer la transparence, pour la 
desactiver ; 

- tres important : la valeur Alpha de la transparence. C'est un nombre compris entre 
(image totalement transparente, done invisible) et 255 (image totalement opaque, 
comme s'il n'y avait pas de transparence Alpha). 

Plus le nombre Alpha est petit, plus l'image est transparente et fondue. 

Voici par exemple un code qui applique une transparence Alpha de 128 a notre Zozor : 

zozor = SDL_LoadBMPCzozor.bmp"); 

SDL_SetColorKey (zozor, SDL_SRCCOLORKEY, SDL_MapRGB(zozor->f ormat , 0, 0, 255)); 

/* Transparence Alpha moyenne (128) : */ 

SDL_SetAlpha(zozor, SDL_SRCALPHA, 128); 

SDL_BlitSurface (zozor, NULL, ecran, ftpositionZozor) ; 

Vous noterez que j'ai conserve la transparence de SDL_SetColorKey. Les deux types 
de transparence sont en effet combinables. 

La fig. 22.6 vous montre a quoi ressemble Zozor selon la valeur Alpha. 

La transparence Alpha 128 (transparence moyenne) est une valeur speciale qui 
est optimisee par la SDL. Ce type de transparence est plus rapide a calculer 
pour votre ordinateur que les autres. C'est peut etre bon a savoir si vous 
utilisez beaucoup de transparence Alpha dans votre programme. 
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Charger plus de formats d'image avec SDL_Image 

La SDL ne gere que les Bitmap (BMP) comme on l'a vu. A priori, ce n'est pas un 
tres gros probleme parce que la lecture des BMP est rapide pour la SDL, mais il 
faut reconnaitre qu'aujourd'hui on a plutot l'habitude d'utiliser d'autres formats. En 
particulier, nous sommes habitues aux formats d'images « compresses » comme le PNG, 
lc GIF et le JPEG. Ca tombe bien, il existe justement une bibliotheque SDL_Image qui 
gere tous les formats suivants : 

- TGA; 
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Figure 22.6 - Niveaux de transparence Alpha 
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- BMP 

- PNM 

- XPM 
XCF 

- PCX 
GIF; 

- JPG; 

- TIF; 

- LBM; 

- PNG. 

II est en fait possible de rajouter des extensions a la SDL. Ce sont des bibliotheques 
qui ont besoin de la SDL pour fonctionner. On peut voir ga comme des add-ons 4 . 
SDL_Image est l'une d'entre elles. 



Installer SDL_image sous Windows 

Telechargement 

Une page speciale du site de la SDL reference les bibliotheques utilisant la SDL. Cette 
page s'intitule Libraries, vous trouverez un lien dans le menu de gauche. Vous pourrez 
voir qu'il y a beaucoup de bibliotheques disponibles. Celles-ci ne proviennent generale- 
ment pas des auteurs de la SDL, ce sont plutot des utilisateurs de la SDL qui proposent 
leurs bibliotheques pour ameliorer la SDL. 

Certaines sont tres bonnes et meritent le detour, d'autres sont moins bonnes et encore 
boguees. II faut arriver a faire le tri. 

Cherchez SDL_Image dans la liste. . . vous arriverez sur la page dediee a SDL_Image. 



> 



Code web : 434672 



Telechargez la version de SDL_Image qui vous correspond dans la section Binary (ne 
prenez PAS la source, on n'en a pas besoin!). Si vous etes sous Windows, telechargez 
SDL_image-devel-l .2. 10-VC.zip, et ce meme si vous n'utilisez pas Visual C++! 



Installation 

Dans ce .zip, vous trouverez : 

- SDL_image.h : le seul header dont a besoin la bibliotheque SDL_Image. Placez-le 
dans C:\Program Files\CodeBlocks\SDL-l . 2 . 13\include, c'est-a-dire a cote des 
autres headers de la SDL ; 

- SDL_image . lib : copiez dans C:\Program Files\CodeBlocks\SDL-l . 2 . 13\lib. Oui, 
je sais, je vous ai dit que normalement les . lib etaient des fichiers reserves a Visual, 
mais ici exceptionnellement le . lib fonctionnera meme avec le compilateur mingw ; 



4. On emploie aussi parfois le mot « greffon », plus francais. 
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- plusieurs DLL : placez-les toutes dans le dossier de votre projet (a cote de SDL.dll, 
done). 

Ensuite, vous devez modifier les options de votre projet pour « linker » avec le fichier 
SDL_image . lib. 

Si vous etes sous Code: :Blocks par exemple, allez dans le menu Projects / Build 
options. Dans l'onglet Linker, cliquez sur le bouton Add et indiquez ou se trouve le 
fichier SDL_image.lib (fig. 22.7). 



Project build options 



i © 



-■Release 



Selected compiler 



| GNU GCC Compiler 



Compiler settings | Linker settings Search directories | Pre/post build steps | Custom vari; 



Policy: Append target options to project options 



Link libraries: 



Other linker options: 



rning'A'32 

SDLmain 

SDL.dll 

user32 

gdi3Z 

winrnrn 

dMgujd 



: 



^jflj I Edit I [ Delete j [ dear 



Copy all to.., 







Figure 22.7 - Selection de SDL_image.lib 

Si on vous demande Keep as a relative path ?, repondez ce que vous voulez, <ja ne 
changera rien dans l'immediat. Je recommande de repondre par la negative, personnel- 
lenient. 

Ensuite, vous n'avez plus qu'a inclure le header SDL_image.h dans votre code source. 
Selon l'endroit ou vous avez place le fichier SDL_image.h, vous devrez soit utiliser ce 
code : 

| # include <SDL/SDL_image.h> 

. . . soit celui-ci : 
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I #include <SDL_image.h> 



Essayez les deux, l'un des deux devrait fonctionner. 



Si vous etes sous Visual Studio, la manipulation est quasiment la meme. Si 
vous avez reussi a installer la SDL, vous n'aurez aucun probleme pour installer 
SDL_ image. 
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Installer SDL_image sous Mac OS X 

Si vous utilisez Mac OS X, telechargez le fichier .dmg sur le site de la SDL, section 
SDL_ image. 



> [ Code web : 434672 ) 

Copiez le fichier SDL_image . framework dans Macintosh HD/Library/Frameworks. Co- 
piez ensuite le fichier SDL_image.h dans SDL. framework/Headers. 

Creez un nouveau projet de type SDL Application et faites Add / Existing 
Frameworks (fig. 22.8). 
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Figure 22.8 - Ajout de SDL_image sous Xcode 

La, selectionnez le fichier SDL_image. framework que vous venez de telecharger. C'est 
tout! 

II faudra en revanche inclure le fichier . h dans votre code comme ceci : 

I #include "SDL_image.h" 
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. . . au lieu d'utiliser des chevrons < >. Remplacez done la ligne d'include de SDL_image 
dans le code qui va suivre par celle que je viens de vous donner. 

Charger les images 

En fait, installer SDL_image est 100 fois plus complique que de l'utiliser, e'est vous dire 
la complexity de la bibliotheque ! 

II y a UNE seule fonction a connaitre : IMG_Load. Elle prend un parametre : le nom 
du fichier a ouvrir. 

Ce qui est pratique, e'est que cette fonction est capable d'ouvrir tous les types de 
flchiers que gere SDL_image (GIF, PNG, JPG, mais aussi BMP, TIF. . .). Elle detectera 
toute seule le type du fichier en fonction de son extension. 

Comme SDL_image peut aussi ouvrir les BMP, vous pouvez meme oublier 
maintenant la fonction SDL_LoadBMP et ne plus utiliser que IMG_Load pour 
le chargement de n'importe quelle image. 
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Autre bon point : si l'image que vous chargez gere la transparence (comme e'est le cas 
des PNG et des GIF), alors SDL_image activera automatiquement la transparence pour 
cette image ! Cela vous evite done d'avoir a appelcr SDL_SetColorKey. 

Je vais vous presenter le code source qui charge sapin.png et l'affiche 5 . Notez bien 
que j 'indue SDL/SDL_ image. h et que je ne fais pas appel a SDL_SetColorKey car mon 
PNG est naturellement transparent. Vous allez voir que j'utilise IMG_Load partout dans 
ce code en remplacement de SDL_LoadBMP. 

#include <stdlib.h> 

#include <stdio.h> 

#include <SDL/SDL.h> 

#include <SDL/SDL_image.h> /* Inclusion du header de SDL_image (adapter le 

M> dossier au besoin) */ 

int main(int argc, char *argv[]) 
{ 

SDL_Surface *ecran = NULL, *imageDeFond = NULL, *sapin = NULL; 

SDL_Rect positionFond, positionSapin; 

/* [...] Chargement de la SDL et d'une image de fond */ 

/* Chargement d'un PNG avec IMG_Load 

Celui-ci est automatiquement rendu transparent car les informations de 

transparence sont codees a l'interieur du fichier PNG */ 

sapin = IMG_Load("sapin.png") ; 

SDL_BlitSurf ace(sapin, NULL, ecran, ftpositionSapin) ; 



5. Je l'ai un peu raccourci pour ne pas encombrer le livre de codes source repetitifs que vous avez 
deja vus plusieurs fois. Si vous voulez obtenir le code source complet, n'hesitez pas a vous rendre au 
code web indique. 
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SDL_Flip(ecran) ; 
pause () ; 

SDL_FreeSurf ace(imageDeFond) ; 
SDL_FreeSurf ace(sapin) ; 
SDL_Quit() ; 

return EXIT_SUCCESS; 



> ( Code web : 528548 ) 

Comme on peut le voir sur la fig. 22.9, l'image PNG a ete inseree avec la transparence 
sur l'image de fond ! 




Figure 22.9 - Une image PNG transparente inseree a l'aide de SDL_image 



En resume 

- La SDL permet de charger des images dans des surfaces. Par defaut, elle ne gere que 
les BMP avec SDL_LoadBMP. 

- On peut definir une couleur transparente avec SDL_SetColorKey. 

- On peut rendre l'ensemble de l'image plus ou moins transparent avec la fonction 
SDL_SetAlpha . 
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La bibliotheque SDL_image permet d'inserer n'importe quel type d'image (PNG, 
JPEG. . .) avec IMG_Load. II faut cependant l'installer en plus de la SDL. 
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Chapitre 



23 



La gestion des evenements 



Difficulty : WB 

La gestion des evenements est une des fonctionnalites les plus importantes de la SDL. 
C'est probablement une des sections les plus passionnantes a decouvrir. C'est a partir 
de la que vous allez vraiment etre capables de controler votre application. 

Chacun de vos peripheriques (clavier, souris. . .) peut produire des evenements. Nous allons 
apprendre a intercepter ces evenements et a reagir en consequence. Votre application va 
done devenir enfin reellement dynamique! 
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Concretement, qu'est-ce qu'un evenement ? C'est un « signal » envoye par un periphe- 
rique (ou par le systeme (Sexploitation) a votre application. Void quelques exemples 
d'evenements courants : 

- quand l'utilisateur appuie sur une touche du clavier ; 

- quand il clique avec la souris ; 

- quand il bouge la souris ; 

- quand il reduit la fenetre ; 

- quand il demande a fermer la fenetre ; 

- etc. 

Le role de ce chapitre sera de vous apprendre a traiter ces evenements. Vous serez 
capables de dire a l'ordinateur « Si l'utilisateur clique a cet endroit, fais <ja, sinon 
fais cela. . . S'il bouge la souris, fais ceci. S'il appuie sur la touche Q, arrete le pro- 
gramme. . . », etc. 



Le principe des evenements 

Pour nous habituer aux evenements, nous allons apprendre a traiter le plus simple 
d'entre eux : la demande de fermeture du programme. C'est un evenement qui 
se produit lorsque l'utilisateur clique sur la croix pour fermer la fenetre (fig. 23.1). 



Figure 23.1 - La croix permettant de fermer la fenetre 

C'est vraiment l'evenement le plus simple. En plus, c'est un evenement que vous avez 
utilise jusqu'ici sans vraiment le savoir, car il etait situe dans la fonction pause () ! En 
effet, le role de la fonction pause etait d'attendre que l'utilisateur demande a fermer le 
programme. Si on n'avait pas cree cette fonction, la fenetre se serait affichee et fermee 
en un eclair ! 

A partir de maintenant, vous pouvez oublier la fonction pause. Supprimez-la 
de votre code source, car nous allons apprendre a la reproduire. 
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La variable d 'evenement 

Pour traiter des evenements, vous aurez besoin de declarer une variable (juste une 
seule, rassurez-vous) de type SDL_Event. Appelez-la comme vous voulez : moi, je vais 
l'appeler event, ce qui signifie « evenement » en anglais. 

I SDL_Event event ; 
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Pour nos tests nous allons nous contenter d'un main tres basique qui affiche juste une 
fenetre, comme on l'a vu quelques chapitres plus tot. Voici a quoi doit ressembler votre 
main : 

int main(int argc, char *argv[]) 
{ 

SDL_Surface *ecran = NULL; 

SDL_Event event; // Cette variable servira plus tard a gerer les evenements 

SDL_Init(SDL_INIT_VIDEO) ; 

ecran = SDL_SetVideoMode(640, 480, 32, SDL_HWSURFACE) ; 
SDL_WM_SetCaption("Gestion des evenements en SDL", NULL); 

SDL_Quit() ; 

return EXIT_SUCCESS; 



t> ( Code web : 842265 ) 

C'est done un code tres basique, il ne contient qu'une nouveaute : la declaration de la 
variable event dont nous allons bientot nous servir. 

Testez ce code : comme prevu, la fenetre va s'afficher et se fermer immediatement apres. 

La boucle des evenements 

Lorsqu'on veut attendre un evenement, on fait generalement une boucle. Cette boucle 
se repetera tant qu'on n'a pas eu l'evenement voulu. On va avoir besoin d'utiliser un 
booleen qui indiquera si on doit continuer la boucle ou non. Creez done ce booleen que 
vous appellerez par exemple continuer : 

lint continuer = 1; 

Ce booleen est mis a 1 au depart car on veut que la boucle se repete TANT QUE la 
variable continuer vaut 1 (vrai). Des qu'elle vaudra (faux), alors on sortira de la 
boucle et le programme s'arretera. 

Voici la boucle a creer : 

while (continuer) 
{ 

/* Traitement des evenements */ 
} 

Voila : on a pour le moment une boucle infinie qui ne s'arretera que si on met la variable 
continuer a 0. C'est ce que nous allons ecrire a l'interieur de cette boucle qui est le 
plus interessant. 
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Recuperation de l'evenement 

Maintenant, faisons appel a une fonction de la SDL pour demander si un evenement 
s'est produit. On dispose de deux fonctions qui font cela, mais d'une maniere differente : 

- SDL_WaitEvent : elle attend qu'un evenement se produise. Cette fonction est dite 
bloquante car elle suspend l'execution du programme tant qu'aucun evenement ne 
s'est produit ; 

- SDL_PollEvent : cette fonction fait la meme chose mais n'est pas bloquante. Elle 
vous dit si un evenement s'est produit ou non. Meme si aucun evenement ne s'est 
produit, elle rend la main a votre programme de suite. 

Ces deux fonctions sont utiles, mais dans des cas differents. Pour faire simple, si vous 
utilisez SDL_WaitEvent votre programme utilisera tres peu de processeur car il atten- 
dra qu'un evenement se produise. En revanche, si vous utilisez SDL_PollEvent, votre 
programme va parcourir votre boucle while et rappeler SDL_PollEvent indefiniment 
jusqu'a ce qu'un evenement se soit produit. A tous les coups, vous utiliserez 100 % du 
processeur. 

Mais alors, il faut tout le temps utiliser SDL_WaitEvent si cette fonction 
utilise moins le processeur, non? 



Non, car il y a des cas ou SDL_PollEvent se revele indispensable. C'est le cas des jeux 
dans lesquels l'ecran se met a jour meme quand il n'y a pas d'evenement. Prenons par 
exemple Tetris : les blocs descendent tout seuls, il n'y a pas besoin que l'utilisateur 
cree d'evenement pour ca ! Si on avait utilise SDL_WaitEvent, le programme serait reste 
« bloque » dans cette fonction et vous n'auriez pas pu mettre a jour l'ecran pour faire 
descendre les blocs ! 





<? 



O 



Comment fait SDL_WaitEvent pour ne pas consommer de processeur? Apres 
tout, la fonction est bien obligee de faire une boucle infinie pour tester tout 
le temps s'il y a un evenement ou non, n'est-ce pas? 



C'est une question que je me posais il y a encore peu de temps. La reponse est un petit 
peu compliquee car ca concerne la fagon dont l'OS gere les processus (les programmes). 
Si vous voulez - mais je vous en parle rapidement -, avec SDL_WaitEvent, le processus 
de votre programme est mis « en pause ». Votre programme n'est done plus traite 
par le processeur. II sera « reveille » par l'OS au moment ou il y aura un evenement. 
Du coup, le processeur se remettra a travailler sur votre programme a ce moment-la. 
Cela explique pourquoi votre programme ne consomme pas de processeur pendant qu'il 
attend l'evenement. 

Je comprends que ce soit un peu abstrait pour vous pour le moment. Et a dire vrai, 
vous n'avez pas besoin de comprendre ga maintenant. Vous assimilerez mieux toutes les 
differences plus loin en pratiquant. Pour le moment, nous allons utiliser SDL_WaitEvent 
car notre programme reste tres simple. Ces deux fonctions s'utilisent de toute fagon de 
la meme maniere. 
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Vous devez envoyer a la fonction l'adresse de votre variable event qui stocke l'evene- 
ment. Comme cette variable n'est pas un pointeur (regardez la declaration a nouveau), 
nous allons mettre le symbole & devant le nom de la variable aim de donner l'adresse : 

I SDL_WaitEvent (ftevent) ; 

Apres appel de cette fonction, la variable event contient obligatoirement un evenement. 

Cela n'aurait pas forcement ete le cas si on avait utilise SDL_PollEvent : 
cette fonction aurait pu renvoyer « Pas d'evenement ». 



Analyse de l'evenement 

Maintenant, nous disposons d'une variable event qui contient des informations sur 
l'evenement qui s'est produit. II faut regarder la sous- variable event. type et faire un 
test sur sa valeur. Generalement on utilise un switch pour tester l'evenement. 

)\ Mais comment sait-on quelle valeur correspond a l'evenement « Quitter », 
J par exemple? 



La SDL nous fournit des constantes, ce qui simplifie grandement l'ecriture du pro- 
gramme. II en existe beaucoup (autant qu'il y a d'evenements possibles). Nous les 
verrons au fur et a mesure tout au long de ce chapitre. 

while (continuer) 
{ 

SDL_WaitEvent (ftevent) ; /* Recuperation de l'evenement dans event */ 

switch(event . type) /* Test du type d'evenement */ 

{ 

case SDL_QUTT: /* Si c'est un evenement de type "Quitter" */ 
continuer = 0; 
break ; 
} 



Voici comment ga fonctionne. 

1. Des qu'il y a un evenement, la fonction SDL_WaitEvent renvoie cet evenement 
dans event. 

2. On analyse le type d'evenement grace a un switch. Le type de l'evenement se 
trouve dans event . type 

3. On teste a l'aide de case dans le switch le type de l'evenement. Pour le moment, 
on ne teste que l'evenement SDL_QUIT (demande de fermeture du programme), 
car c'est le seul qui nous interesse. 
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- Si c'est un evenement SDL_QUIT, c'est que l'utilisateur a demande a quitter le 
programme. Dans ce cas on met le booleen continuer a 0. Au prochain tour 
de boucle, la condition sera fausse et done la boucle s'arretera. Le programme 
s'arretera ensuite. 

- Si ce n'est pas un evenement SDL_QUIT, c'est qu'il s'est passe autre chose : 
l'utilisateur a appuye sur une touche, a clique ou tout simplement bouge la 
souris dans la fenetre. Comme ces autres evenements ne nous interessent pas, 
on ne les traite pas. On ne fait done rien : la boucle recommence et on attend 
a nouveau un evenement (on repart a l'etape 1). 

Ce que je viens de vous expliquer ici est extremement important. Si vous avez compris 
ce code, vous avez tout compris et le reste du chapitre sera tres facile pour vous. 

Le code complet 

int main(int argc, char *argv[]) 
{ 

SDL_Surface *ecran = NULL; 

SDL_Event event; /* La variable contenant 1 'evenement */ 

int continuer = 1; /* Notre booleen pour la boucle */ 

SDL_Init(SDL_INIT_VIDEO) ; 

ecran = SDL_SetVideoMode(640, 480, 32, SDL_HWSURFACE) ; 

SDL_WM_SetCaption("Gestion des evenements en SDL", NULL); 

while (continuer) /* TANT QUE la variable ne vaut pas */ 
{ 

SDL_WaitEvent (ftevent) ; /* On attend un evenement qu'on recupere dans 
<—¥ event */ 

switch(event . type) /* On teste le type d' evenement */ 
{ 

case SDL_QUIT: /* Si c'est un evenement QUITTER */ 

continuer =0; /* On met le booleen a 0, done la boucle va 
<—¥ s'arreter */ 

break ; 
} 
} 

SDL_Quit() ; 

return EXIT_SUCCESS; 



Code web : 859823 



Voila le code complet. II n'y a rien de bien difficile : si vous avez suivi jusqu'ici, 5a ne 
devrait pas vous surprendre. D'ailleurs, vous remarquerez qu'on n'a fait que reproduire 
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ce que faisait la fonction pause 1 . 



Le clavier 

Nous allons maintenant etudier les evenements produits par le clavier. 

Si vous avez compris le debut du chapitre, vous n'aurez aucun probleme pour traiter 
les autres types d'evenements. II n'y a rien de plus facile. 

Pourquoi est-ce si simple ? Parce que maintenant que vous avez compris le fonctionne- 
ment de la boucle infinie, tout ce que vous allez avoir a faire, c'est d'ajouter d'autres 
case dans le switch pour traiter d'autres types d'evenements. Qa ne devrait pas etre 
trop dur. 

Les evenements du clavier 

II existe deux evenements differents qui peuvent etre generes par le clavier : 

- SDL_KEYDOWN : quand une touche du clavier est enfoncee ; 

- SDL_KEYUP : quand une touche du clavier est relachee. 

Pourquoi y a-t-il ces deux evenements ? Parce que quand vous appuyez sur une touche, 
il se passe deux choses : vous enfoncez la touche (SDL_KEYDOWN), puis vous la relachez 
(SDL_KEYUP). La SDL vous permet de traiter ces deux evenements a part, ce qui sera 
bien pratique, vous verrez. 

Pour le moment, nous allons nous contenter de traiter l'evenement SDL_KEYDOWN (appui 
de la touche) : 

while (continuer) 
{ 

SDL_WaitEvent (ftevent) ; 
switch(event . type) 
{ 

case SDL_QUIT: 

continuer = 0; 
break ; 
case SDL_KEYD0WN: /* Si appui sur une touche */ 
continuer = 0; 
break ; 



Si on appuie sur une touche, le programme s'arrete. Testez, vous verrez ! 



1. Comparez avec le code de la fonction pause : c'est le meme, sauf qu'on a cette fois tout mis dans 
le main. Bien entendu, il est preferable de placer ce code dans une fonction a part, comme pause, car 
cela allege la fonction main et la rend plus lisible. 
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Recuperer la touche 

Savoir qu'une touche a ete enfoncee c'est bien, mais savoir laquelle, c'est quand meme 
mieux ! 

On peut obtenir la nature de la touche enfoncee grace a une sous-sous-sous-variable 
(ouf) qui s'appelle event .key .key sym. sym. Cette variable contient la valeur de la 
touche qui a ete enfoncee 2 . 




a 



L'avantage, c'est que la SDL permet de recuperer la valeur de toutes les 
touches du clavier. II y a les lettres et les chiffres, bien sur (ABCDE0123. . .), 
mais aussi la touche Echap, ou encore Impr. Ecran, Suppr, Entree, etc. 



II y a une constante pour chacune des touches du clavier. Vous trouverez cette liste 
dans la documentation de la SDL, que vous avez tres probablement telechargee avec la 
bibliotheque quand vous avez du l'installer. Si tel n'est pas le cas, je vous recommande 
fortement de retourner sur le site de la SDL et d'y telecharger la documentation, car 
elle est tres utile. 

Vous trouverez la liste des touches du clavier dans la section Keysym definitions. 
Cette liste est trop longue pour etre presentee ici (voir un apergu fig. 23.2), aussi je 
vous propose pour cela de consulter la documentation sur le web directement. 



> [ Code web : 235529 ) 



SDLKey ASCII value Common name 


SDLK BACKSPACE '\b' backspace 


SDLKTAB '\t' tab 


SDLK CLEAR clear 


SDLK RETURN '\r' return 


SDLKPAUSE pause 


SDLK ESCAPE '"[' escape 


SDLKSPACE ' ' space 


SDLK EXCLAIM '!' exclaim 



Figure 23.2 - Apergu de la documentation des constantes du clavier 

Bien entendu, la documentation est en anglais et done. . . la liste aussi. Si vous voulez 
vraiment programmer, il est important d'etre capable de lire l'anglais car toutes les 
documentations sont dans cette langue, et vous ne pouvez pas vous en passer ! 

II y a deux tableaux dans cette liste : un grand (au debut) et un petit (a la fin). Nous 
nous interesserons au grand tableau. Dans la premiere colonne vous avez la constante, 
dans la seconde la representation equivalente en ASCII 3 et enfin, dans la troisieme 
colonne, vous avez une description de la touche. 

Prenons par exemple la touche Echap (« Escape » en anglais). On peut verifier si la 
touche enfoncee est Echap comme ceci : 



2. Elle fonctionne aussi lors d'un relachement de la touche SDL_KEYUP. 

3. Notez que certaines touches comme Maj (ou Shift) n'ont pas de valeur ASCII correspondante. 
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switch (event .key .keysym.sym) 
{ 

case SDLK_ESCAPE: /* Appui sur la touche Echap, on arrete le programme */ 

continuer = 0; 

break; 



} 




a 



J 'utilise un switch pour faire mon test mais j'aurais aussi bien pu utiliser un 
if. Toutefois, j'ai plutot tendance a me servir des switch quand je traite 
les evenements car je teste beaucoup de valeurs differentes (en pratique, j'ai 
beaucoup de case dans un switch, contrairement a ici). 



Voici une boucle d'evenement complete que vous pouvez tester : 



while (continuer) 
{ 

SDL_WaitEvent (ftevent) ; 
switch(event . type) 
{ 

case SDL_QUIT: 

continuer = 0; 
break ; 
case SDL_KEYD0WN: 

switch (event .key .keysym. sym) 
{ 

case SDLK_ESCAPE: /* Appui sur la touche Echap, on arrete le 
c -> programme */ 

continuer = 0; 
break; 
} 

break ; 
} 
} 



Cette fois, le programme s'arrete si on appuie sur Echap ou si on clique sur la croix de 
la fenetre. 

Maintenant que vous savez comment arreter le programme en appuyant sur 
une touche, vous etes autorises a faire du plein ecran si ca vous amuse 4 . 
Auparavant, je vous avais demande d'eviter de le faire car on ne savait pas 
comment arreter un programme en plein ecran (il n'y a pas de croix sur 
laquelle cliquer pour arreter !). 




a 



4. Flag SDL_FULLSCREEN dans SDL_SetVideoMode, pour rappel. 
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Exercice : diriger Zozor au clavier 

Vous etes maintenant capables de deplacer une image dans la fenetre a l'aide du clavier ! 
C'est un exercice tres interessant qui va d'ailleurs nous permettre de voir comment 
utiliser le double buffering et la repetition de touches. De plus, ce que je vais vous 
apprendre la est la base de tous les jeux realises en SDL, done ce n'est pas un 
exercice facultatif ! Je vous invite a le lire et a le faire tres soigneusement. 

Charger l'image 

Pour commencer, nous allons charger une image. On va faire simple : on va reprendre 
l'image de Zozor utilisee dans le chapitre precedent. Creez done la surface zozor, 
chargez l'image et rendez-la transparente (e'etait un BMP, je vous le rappelle). 

zozor = SDL_LoadBMPCzozor.bmp"); 

SDL_SetColorKey (zozor, SDL_SRCCOLORKEY, SDL_MapRGB(zozor->f ormat , 0, 0, 255)); 



Ensuite, et c'est certainement le plus important, vous devez creer une variable de type 
SDL_Rect pour retenir les coordonnees de Zozor : 

I SDL_Rect positionZozor; 

Je vous recommande d'initialiser les coordonnees, en mettant soit x = et y = 
(position en haut a gauche de la fenetre) , soit en centrant Zozor dans la fenetre comme 
vous avez appris a le faire il n'y a pas si longtemps. 



II* On centre Zozor a l'ecran */ 
positionZozor .x = ecran->w 11- zozor->w / 2; 
positionZozor .y = ecran->h / 2 - zozor->h / 2; 



© 



Vous devez initialiser positionZozor apres avoir charge les surfaces ecran 
et zozor. En effet, j 'utilise la largeur (w) et la hauteur (h) de ces deux 
surfaces pour calculer la position centree de Zozor a l'ecran, il faut done que 
ces surfaces aient ete initialisees auparavant. 



Si vous vous etes bien debrouilles, vous devriez avoir reussi a afficher Zozor au centre 
de l'ecran (fig. 25.1). 

J'ai choisi de mettre le fond en blanc cette fois (en faisant un SDL_FillRect sur ecran), 
mais ce n'est pas une obligation. 

Schema de la programmation evenementielle 

Quand vous codez un programme qui reagit aux evenements (comme on va le faire ici) , 
vous devez suivre la plupart du temps le meme « schema » de code. Ce schema est a 
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Figure 23.3 - Zozor centre dans la fenetre 



connaitre par cceur. Le voici : 



while (continuer) 
{ 

SDL_WaitEvent (ftevent) ; 
switch(event . type) 
{ 

case SDL_TRUC: /* Gestion des evenements de type TRUC */ 
case SDL_BIDULE: /* Gestion des evenements de type BIDULE */ 
} 

/* On efface l'ecran (ici fond blanc) : */ 

SDL_FillRect(ecran, NULL, SDL_MapRGB(ecran->f ormat , 255, 255, 255)); 

/* On fait tous les SDL_BlitSurface necessaires pour coller les surfaces a 
'-¥ l'ecran */ 

/* On met a jour l'affichage : */ 
SDL_Flip(ecran) ; 



Voila dans les grandes lignes la forme de la boucle principale d'un programme SDL. 
On boucle tant qu'on n'a pas demande a arreter le programme. 
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1. On attend un evenement (SDL_WaitEvent) ou bien on verifie s'il y a un 
evenement mais on n'attend pas qu'il y en ait un (SDL_PollEvent). Pour le 
moment on se contente de SDL_WaitEvent. 

2. On fait un (grand) switch pour savoir de quel type d'evenement il s'agit (eve- 
nement de type TRUC, de type BIDULE, comme <ja vous chante!). On traite 
l'evenement qu'on a regu : on effectue certaines actions, certains calculs. 

3. Une fois sorti du switch, on prepare un nouvel affichage : 

(a) premiere chose a faire : on efface l'ecran avec un SDL_FillRect. Si on ne 
le faisait pas, on aurait des « traces » de l'ancien ecran qui subsisteraient, 
et forcement, ce ne serait pas tres joli ; 

(b) ensuite, on fait tous les blits necessaires pour coller les surfaces sur l'ecran ; 

(c) enfin, une fois que c'est fait, on met a jour l'afflchage aux yeux de l'uti- 
lisateur, en appelant la fonction SDL_Flip (ecran). 

Traiter l'evenement SDL.KEYDOWM 

Voyons maintenant comment on va traiter l'evenement SDL_KEYDOWN. Notre but est 
de diriger Zozor au clavier avec les fleches directionnelles. On va done modifier ses 
coordonnees a l'ecran en fonction de la fleche sur laquelle on appuie : 

switch (event . type) 
{ 

case SDL_QUIT: 

continuer = 0; 
break; 
case SDL_KEYD0WN: 

switch (event .key .keysym.sym) 
{ 

case SDLK_UP: // Fleche haut 
posit ionZozor .y-- ; 
break ; 
case SDLK_D0WN: // Fleche bas 
positionZozor . y++ ; 
break ; 
case SDLK_RIGHT: // Fleche droite 
positionZozor . x++ ; 
break ; 
case SDLK_LEFT: // Fleche gauche 
positionZozor .x-- ; 
break ; 
} 

break; 
} 

Comment j'ai trouve ces constantes ? Dans la doc' ! Je vous ai donne tout a l'heure un 
lien vers la page de la doc' qui liste toutes les touches du clavier : c'est la que je me 
suis servi. 
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Code web : 235529 



Ce qu'on fait la est tres simple : 

- si on appuie sur la fleche « haut », on diminue l'ordonnee (y) de la position de Zozor 
d'un pixel 5 pour le faire « monter » ; 

- si on va vers le bas, on doit au contraire augmenter (incrementer) l'ordonnee de Zozor 

(y); 

- si on va vers la droite, on augmente la valeur de l'abscisse (x) ; 

- si on va vers la gauche, on doit diminuer l'abscisse (x). 

Et maintenant ? En vous aidant du schema de code donne precedemment, vous devriez 
etre capables de diriger Zozor au clavier ! 

int main(int argc, char *argv[]) 
{ 

SDL_Surface *ecran = NULL, *zozor = NULL; 

SDL_Rect positionZozor ; 

SDL_Event event ; 

int continuer = 1; 

SDL_Init(SDL_INIT_VIDEO) ; 

ecran = SDL_SetVideoMode(640, 480, 32, SDL_HWSURFACE) ; 
SDL_WM_SetCaption("Gestion des evenements en SDL", NULL); 

/* Chargement de Zozor */ 

zozor = SDL_LoadBMP ( "zozor. bmp" ) ; 

SDL_SetColorKey(zozor, SDL_SRCC0L0RKEY, SDL_MapRGB(zozor->f ormat , 0, 0, 255)); 

/* On centre Zozor a 1' ecran */ 

positionZozor .x = ecran->w II- zozor->w / 2; 

positionZozor .y = ecran->h II- zozor->h / 2; 

while (continuer) 
{ 

SDL_WaitEvent (ftevent) ; 
switch(event .type) 
{ 

case SDL_QUIT: 

continuer = 0; 
break; 
case SDL_KEYD0WN: 

switch (event .key .keysym. sym) 
{ 

case SDLK_UP: // Fleche haut 
positionZozor . y-- ; 
break; 
case SDLK_D0WN: // Fleche bas 



5. Notez que nous ne sommes pas obliges de le deplacer d'un pixel, on pourrait tres bien le deplacer 
de 10 pixels en 10 pixels. 
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positionZozor . y++ ; 

break ; 
case SDLK_RIGHT: // Fleche droite 

positionZozor . x++ ; 

break ; 
case SDLK_LEFT: // Fleche gauche 

positionZozor .x-- ; 

break ; 
} 
break ; 



/* On efface l'ecran */ 

SDL_FillRect(ecran, NULL, SDL_MapRGB(ecran->f ormat , 255, 255, 255)); 

/* On place Zozor a sa nouvelle position */ 

SDL_BlitSurf ace(zozor , NULL, ecran, ftpositionZozor) ; 

/* On met a jour l'affichage */ 

SDL_Flip (ecran) ; 



SDL_FreeSurf ace (zozor) ; 
SDL_Quit() ; 



return EXIT_SUCCESS; 



} 



> [Code web : 252188) 

II est primordial de bien comprendre comment est composee la boucle principale du 
programme. II faut etre capable de la refaire de tete. Relisez le schema de code que 
vous avez vu plus haut, au besom. 

Done en resume, on a une grosse boucle appelee « Boucle principale du programme ». 
Elle ne s'arretera que si on le demande en mettant le booleen continuer a 0. Dans cette 
boucle, on recupere d'abord un evenement a traiter. On fait un switch pour determiner 
de quel type d'evenement il s'agit. En fonction de l'evenement, on effectue differentes 
actions. Ici, je mets a jour les coordonnees de Zozor pour donner l'impression qu'on le 
deplace. 

Ensuite, apres le switch vous devez mettre a jour votre ecran comme suit. 

1. Premierement, vous effacez l'ecran via un SDL_FillRect (de la couleur de fond 
que vous voulez). 

2. Ensuite, vous blittez vos surfaces sur l'ecran. Ici, je n'ai eu besoin de blitter que 
Zozor car il n'y a que lui. Vous noterez, et e'est tres important, que je blitte 
Zozor a positionZozor! C'est la que la difference se fait : si j'ai mis a jour 
positionZozor auparavant, alors Zozor apparaitra a un autre endroit et on aura 
l'impression qu'on l'a deplace ! 

3. Enfin, toute derniere chose a faire : SDL_Flip. Cela ordonne la mise a jour de 
l'ecran aux yeux de l'utilisateur. 
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On peut done deplacer Zozor ou l'on veut sur l'ecran, maintenant (fig. 23.4) ! 




Figure 23.4 - Zozor en balade 



Quelques optimisations 

Repetition des touches 

Pour l'instant, notre programme fonctionne mais on ne peut se deplacer que d'un 
pixel a la fois. Nous sommes obliges d'appuyer a nouveau sur les fleches du clavier 
si on veut encore se deplacer d'un pixel. Je ne sais pas vous, mais moi ga m'amuse 
moyennement de m'exciter frenetiquement sur la meme touche du clavier juste pour 
deplacer le personnage de 200 pixels. 

Heureusement, il y a SDL_EnableKeyRepeat ! Cette fonction permet d'activer la re- 
petition des touches. Elle fait en sorte que la SDL regenere un evenement de type 
SDL_KEYD0WN si une touche est maintenue enfoncee un certain temps. 

Cette fonction peut etre appelee quand vous voulez, mais je vous conseille de l'appeler 
de preference avant la boucle principale du programme. Elle prend deux parametres : 

- la duree (en millisecondes) pendant laquelle une touche doit rester enfoncee avant 
d'activer la repetition des touches ; 

- le delai (en millisecondes) entre chaque generation d'un evenement SDL_KEYD0WN une 
fois que la repetition a ete activee. 
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Le premier parametre indique au bout de combien de temps on genere une repetition 
la premiere fois, et le second indique le temps qu'il faut ensuite pour que l'evenement 
se repete. Personnellement, pour des raisons de fiuidite, je mets la meme valeur a ces 
deux parametres, le plus souvent. 

Essayez avec une repetition de 10 ms : 

| SDL_EnableKeyRepeat(10, 10); 

Maintenant, vous pouvez laisser une touche du clavier enfoncee. Vous allez voir, c'est 
quand meme mieux ! 

Travailler avec le double buffer 



A partir de maintenant, il serait bon d'activer l'option de double buffering de la 
SDL. 

Le double buffering est une technique couramment utilisee dans les jeux. Elle permet 
d'eviter un scintillement de l'image. Pourquoi l'image scintillerait-elle ? Parce que quand 
vous dessinez a l'ecran, l'utilisateur « voit » quand vous dessinez et done quand l'ecran 
s'efface. Meme si <ja va tres vite, notre cerveau pergoit un clignotement et c'est tres 
desagreable. 

La technique du double buffering consiste a utiliser deux « ecrans » : l'un est reel (celui 
que l'utilisateur est en train de voir sur son moniteur), l'autre est virtuel (c'est une 
image que l'ordinateur est en train de construire en memoire). 

Ces deux ecrans alternent : l'ecran A est affiche pendant que l'autre (l'ecran B) en 
« arriere-plan » prepare l'image suivante (fig. 23.5). 



Utilisateur 





Ecran B 
(image en preparation) 



Ecran A 
(image visible) 



Figure 23.5 - En double buffering, l'image suivante est preparee en tache de fond 

Une fois que l'image en arriere-plan (l'ecran B) a ete dessinee, on intervertit les deux 
ecrans en appelant la fonction SDL_Flip (fig. 23.6). 

L'ecran A part en arriere-plan preparer l'image suivante, tandis que l'image de l'ecran 
B s'afHche directement et instantanement aux yeux de l'utilisateur. Resultat : aucun 
scintillement ! 
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SDL_Flip 



Utilisateur 




Ecran B 



Ecran A 
(image en preparation} 



(image visible) 
Figure 23.6 - SDL_Flip intervertit les ecrans pour afficher la nouvelle image 



Pour realiser cela, tout ce que vous avez a faire est de charger le mode video en ajoutant 
le flag SDL_DOUBLEBUF : 



| ecran = SDL_SetVideoMode(640, 480, 32, SDL_HWSURFACE I SDL_D0UBLEBUF) ; 



Vous n'avez rien d'autre a changer dans votre code. 



Le double buffering est une technique bien connue de votre carte graphique. 
C'est done directement gere par le materiel et ca va tres tres vite. 




a 



Vous vous demandez peut-etre pourquoi on a deja utilise SDL_Flip auparavant sans le 
double buffering? En fait, cette fonction a deux utilites : 

- si le double buffering est active, elle sert a commander « l'echange » des ecrans qu'on 
vient de voir ; 

- si le double buffering n'est pas active, elle commande un rafraichissement manuel de 
la fenetre. Cette technique est valable dans le cas d'un programme qui ne bouge pas 
beaucoup, mais pour la plupart des jeux, je recommande de l'activer. 

Dorenavant, j'aurai toujours le double buffering active dans mes codes source 6 . 

Si vous le souhaitez, vous pouvez recuperer le code source complet qui fait usage du 
double buffering et de la repetition des touches. II est tres similaire a celui que l'on 
a vu precedemment, on y a seulement ajoute les nouvelles instructions qu'on vient 
d'apprendre. 



> Code web : 618870 



6. Ca ne coute pas plus cher et c'est mieux : de quoi se plaint -on ' 
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La souris 

Vous vous dites peut-etre que gerer la souris est plus complique que le clavier? Que 
nenni ! C'est meme plus simple, vous allez voir! 

La souris peut generer trois types d'evenements differents. 

- SDL_M0USEBUTT0ND0WN : lorsqu'on clique avec la souris. Cela correspond au moment 
ou le bout on de la souris est enfonce. 

- SDL_MOUSEBUTTONUP : lorsqu'on relache le bouton de la souris. Tout cela fonctionne 
exactement sur le meme principe que les touches du clavier : il y a d'abord un appui, 
puis un relachement du bouton. 

- SDL_M0USEM0TI0N : lorsqu'on deplace la souris. A chaque fois que la souris bouge 
dans la fenetre (ne serait-ce que d'un pixel!), un evenement SDL_M0USEM0TI0N est 
genere ! 

Nous allons d'abord travailler avec les clics de la souris et plus particulierement avec 
SDL_MOUSEBUTTONUP. On ne travaillera pas avec SDL_M0USEBUTT0ND0WN ici, mais vous 
savez de toute maniere que c'est exactement pareil sauf que cela se produit plus tot, 
au moment de l'enfoncement du bouton de la souris. Nous verrons un peu plus loin 
comment traiter l'evenement SDL_M0USEM0TI0N. 

Gerer les clics de la souris 

Nous allons done capturer un evenement de type SDL_MOUSEBUTTONUP (clic de la souris) 
puis voir quelles informations on peut recuperer. Comme d'habitude, on va devoir 
ajouter un case dans notre switch de test, alors allons-y gaiement : 

switch (event . type) 
{ 

case SDL_QUIT: 

continuer = 0; 
break; 
case SDL_M0USEBUTT0NUP : /* Clic de la souris */ 
break; 
} 

Jusque-la, pas de difficulte majeure. 

Quelles informations peut-on recuperer lors d'un clic de la souris ? II y en a deux : 

- le bouton de la souris avec lequel on a clique (clic gauche ? clic droit ? clic bouton 
du milieu ?) ; 

- les coordonnees de la souris au moment du clic (x et y). 

Recuperer le bouton de la souris 

On va d'abord voir avec quel bouton de la souris on a clique. Pour cela, il faut analyser 
la sous- variable event .button. button (non, je ne begaie pas) et comparer sa valeur 
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avec l'une des 5 constantes suivantes : 

- SDL_BUTTON_LEFT : clic avec le bouton gauche de la souris ; 

- SDL_BUTTON_MIDDLE : clic avec le bouton du milieu de la souris 7 ; 

- SDL_BUTTON_RIGHT : clic avec le bouton droit de la souris ; 

- SDL_BUTTON_WHEELUP : molette de la souris vers le haut ; 

- SDL_BUTTON_WHEELDOWN : molette de la souris vers le bas. 

Les deux dernieres constantes correspondent au mouvement vers le haut ou 
vers le bas auquel on procede avec la molette de la souris. Elles ne corres- 
pondent pas a un « clic » sur la molette comme on pourrait le penser a 
tort. 
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On va faire un test simple pour verifier si on a fait un clic droit avec la souris. Si on a 
fait un clic droit, on arrete le programme (oui, je sais, ce n'est pas tres original pour le 
moment mais <ja permet de tester) : 

switch(event .type) 
{ 

case SDL_QUIT: 

continuer = 0; 
break; 
case SDL_M0USEBUTT0NUP : 

if (event. button. button == SDL_BUTTuN_RIGHT) /* On arrete le programme 
=->• si on a fait un clic droit */ 

continuer = 0; 
break; 



Vous pouvez tester, vous verrez que le programme s'arrete si on fait un clic droit. 

Recuperer les coordonnees de la souris 

Voila une information tres interessante : les coordonnees de la souris au moment 
du clic ! On les recupere a l'aide de deux variables (pour l'abscisse et l'ordonnee) : 
event .button. x et event .button. y. 

Amusons-nous un petit peu : on va blitter Zozor a l'endroit du clic de la souris. Com- 
plique? Pas du tout ! Essayez de le faire, c'est un jeu d'enfant ! 

Voici la correction : 

while (continuer) 
{ 

SDL_WaitEvent (ftevent) ; 

switch(event . type) 

{ 



7. Tout le monde n'en a pas forcement un, c'est en general un clic avec la molette. 
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case SDL_QUIT: 

continuer = 0; 

break; 
case SDL_M0USEBUTT0NUP: 

positionZozor .x = event .button. x; 

positionZozor .y = event .button. y; 

break; 



SDL_FillRect(ecran, NULL, SDL_MapRGB(ecran->f ormat , 255, 255, 255)); 
SDL_BlitSurf ace(zozor, NULL, ecran, ftpositionZozor) ; /* On place Zozor a sa 
nouvelle position */ 
SDL_Flip (ecran) ; 



Qa ressemble a s'y meprendre a ce que je faisais avec les touches du clavier. La, 
c'est meme encore plus simple : on met directement la valeur de x de la souris dans 
positionZozor .x, et de meme pour y. Ensuite on blitte Zozor a ces coordonnees-la, 
et voila le travail (fig. 23.7) ! 




Figure 23.7 - Zozor apparait a l'endroit du clic 

Petit exercice tres simple : pour le moment, on deplace Zozor quel que soit le bouton de 
la souris utilise pour le clic. Essayez de ne deplacer Zozor que si on fait un clic gauche 
avec la souris. Si on fait un clic droit, arretez le programme. 
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Gerer le deplacement de la souris 

Un deplacement de la souris genere un evenement de type SDL_M0USEM0TI0N. Notez 
bien qu'on genere autant d'evenements que l'on parcourt de pixels pour se deplacer ! 
Si on bouge la souris de 100 pixels (ce qui n'est pas beaucoup), il y aura done 100 
evenements generes. 




f 



Mais ca ne fait pas beaucoup d'evenements a gerer pour notre ordinateur, 
tout ca ? 



Pas du tout : rassurez-vous, il en a vu d'autres ! 

Bon, que peut-on recuperer d'interessant ici? Les coordonnees de la souris, bien sur! 
On les trouve dans event .mot ion. x et event .motion, y. 
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Faites attention : on n'utilise pas les memes variables que pour le die de souris 
de tout a I'heure (avant, e'etait event . button. x). Les variables utilisees sont 
differentes en SDL en fonction de I'evenement. 



On va placer Zozor aux memes coordonnees que la souris, la encore. Vous allez voir, 
e'est rudement efficace et toujours aussi simple ! 



while (continuer) 
{ 

SDL_WaitEvent (feevent) ; 
switch(event . type) 
{ 

case SDL_QUIT: 

continuer = 0; 
break ; 
case SDL_MuUSEM0TI0N: 

positionZozor .x = event .motion. x; 
positionZozor .y = event .motion. y; 
break ; 
} 

SDL_FillRect(ecran, NULL, SDL_MapRGB(ecran->f ormat , 255, 255, 255)); 

SDL_BlitSurf ace (zozor, NULL, ecran, ftpositionZozor) ; /* On place Zozor a sa 
<— > nouvelle position */ 

SDL_Flip (ecran) ; 
} 



Bougez votre Zozor a l'ecran. Que voyez-vous ? II suit naturellement la souris ou que 
vous alliez. C'est beau, e'est rapide, e'est fluide (vive le double buffering). 
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Quelques autres fonctions avec la souris 

Nous allons voir deux fonctions tres simples en rapport avec la souris, puisque nous y 
sommes. Ces fonctions vous seront tres probablement utiles bientot. 

Masquer la souris 

On peut masquer le curseur de la souris tres facilement. II suffit d'appeler la fonction 
SDL_ShowCursor et de lui envoyer un flag : 

- SDL_DISABLE : masque le curseur de la souris ; 

- SDL_ENABLE : rcaffichc lc curseur de la souris. 

Par exemple : 

| SDL_ShowCursor(SDL_DISABLE) ; 

Le curseur de la souris restera masque tant qu'il sera a l'interieur de la fenetre. Masquez 
de preference le curseur avant la boucle principale du programme. Pas la peine en effet 
de le masquer a chaque tour de boucle, une seule fois suffit. 

Placer la souris a un endroit precis 

On peut placer manuellement le curseur de la souris aux coordonnees que l'on veut 
dans la fenetre. On utilise pour cela SDL_WarpMouse qui prend pour parametres les 
coordonnees x et y ou le curseur doit etre place. 

Par exemple, le code suivant place la souris au centre de l'ecran : 
I SDL_WarpMouse(ecran->w / 2, ecran->h / 2); 



Lorsque vous faites un WarpMouse, un evenement de type SDL_M0USEM0TI0N 
sera genere. Eh oui, la souris a bouge ! Meme si ce n'est pas I'utilisateur qui 
I'a fait, il y a quand meme eu un deplacement. 
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Les evenements de la fenetre 

La fenetre elle-meme peut generer un certain nombre d'evenements : 

- lorsqu'elle est redimensionnee ; 

- lorsqu'elle est reduite en barre des taches ou restauree ; 

- lorsqu'elle est active (au premier plan) ou lorsqu'elle n'est plus active ; 

- lorsque le curseur de la souris se trouve a l'interieur de la fenetre ou lorsqu'il en sort. 

Commengons par etudier le premier d'entre eux : l'evenement genere lors du redimen- 
sionnement de la fenetre. 
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Redimensionnement de la fenetre 

Par defaut, une fenetre SDL ne peut pas etre redimensionnee par l'utilisateur. Je vous 
rappelle que pour changer <ja, il faut ajouter le flag SDL_RESIZABLE dans la fonction 
SDL_SetVideoMode : 

ecran = SDL_SetVideoMode(640, 480, 32, SDL_HWSURFACE I SDL_D0UBLEBUF I 

^ SDL_RESIZABLE) ; 

Une fois que vous avez ajoute ce flag, vous pouvez redimensionner la fenetre. Lorsque 
vous faites cela, un evenement de type SDL_VIDEORESIZE est genere. 

Vous pouvez recuperer : 

- la nouvelle largeur dans event .re size. w; 

- la nouvelle hauteur dans event .resize, h. 

On peut utiliser ces informations pour faire en sorte que notre Zozor soit toujours 
centre dans la fenetre : 

case SDL_VIDEORESIZE: 

positionZozor .x = event .resize . w 11- zozor->w / 2; 
positionZozor .y = event .resize .h / 2 - zozor->h / 2; 
break ; 



Visibilite de la fenetre 

L'evenement SDL_ACTIVEEVENT est genere lorsque la visibilite de la fenetre change. 
Cela peut etre du a de nombreuses choses : 

- la fenetre est reduite en barre des taches ou restauree ; 

- le curseur de la souris se trouve a l'interieur de la fenetre ou en sort ; 

- la fenetre est active (au premier plan) ou n'est plus active. 

En programmation, on parle de focus. Lorsqu'on dit qu'une application a le 
focus, c'est que le clavier ou la souris de l'utilisateur s'y trouve. Tous les dies 
sur la souris ou appuis sur les touches du clavier que vous ferez seront envoyes 
a la fenetre qui a le focus et non aux autres. Une seule fenetre peut avoir le 
focus a un instant donne (vous ne pouvez pas avoir deux fenetres au premier 
plan en meme temps !). 
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Etant donne le nombre de raisons qui peuvent avoir provoque cet evenement, il faut 
imperativement regarder dans des variables pour en savoir plus. 

- event . active .gain : indique si l'evenement est un gain (1) ou une perte (0). Par 
exemple, si la fenetre est passee en arriere-plan c'est une perte (0), si elle est remise 
au premier plan c'est un gain (1). 

- event . active . state : c'est une combinaison de flags indiquant le type d'evenement 
qui s'est produit. Voici la liste des flags possibles : 
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- SDL_APPMOUSEFOCUS : le curseur de la souris vient de rentrer ou de sortir de la 
fenetre. II faut regarder la valeur de event .active, gain pour savoir si elle est 
rentree (gain = 1) ou sortie (gain = 0) de la fenetre ; 

- SDL_APPINPUTFOCUS : l'application vient de recevoir le focus du clavier ou de le 
perdre. Cela signifie en fait que votre fenetre vient d'etre mise au premier plan ou 
en arriere-plan. Encore une fois, il faut regarder la valeur de event .active. gain 
pour savoir si la fenetre a ete mise au premier plan (gain = 1) ou en arriere-plan 
(gain = 0) ; 

- SDL_APPACTIVE : l'applicaton a ete iconifiee, c'est-a-dire reduite dans la barre des 
taches (gain = 0), ou remise dans son etat normal (gain = 1). 

Vous suivez toujours ? II faut bien comparer les valeurs des deux sous- variables gain 
et state pour savoir exactement ce qui s'est produit. 

Tester la valeur d'une combinaison de flags 

event .active, state est une combinaison de flags. Cela signifie que dans un evene- 
ment, il peut se produire deux choses a la fois (par exemple, si on reduit la fenetre dans 
la barre des taches, on perd aussi le focus du clavier et de la souris). II va done falloir 
faire un test un peu plus complique qu'un simple. . . 

| if (event. active. state == SDL_APP ACTIVE) 
Pourquoi est-ce plus complique? 
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Parce que e'est une combinaison de bits. Je ne vais pas vous faire un cours sur les 
operations logiques bit a bit ici, ga serait un peu trop pour ce cours et vous n'avez pas 
necessairement besoin d'en connaitre davantage. Je vais vous proposer un code pret 
a l'emploi qu'il faut utiliser pour tester si un flag est present dans une variable sans 
rentrer dans les details. 

Pour tester par exemple s'il y a eu un changement de focus de la souris, on doit ecrire : 

| if ((event. active. state & SDL_APPM0USEF0CUS) == SDL_APPM0USEF0CUS) 

II n'y a pas d'erreur. Attention, e'est precis : il faut un seul & et deux =, et il faut bien 
utiliser les parentheses comme je l'ai fait. 

Cela fonctionne de la meme maniere pour les autres evenements. Par exemple : 
| if ((event. active. state & SDL_APP ACTIVE) == SDL_APP ACTIVE) 

Tester l'etat et le gain a la fois 

Dans la pratique, vous voudrez surement tester l'etat et le gain a la fois. Vous pourrez 
ainsi savoir exactement ce qui s'est passe. 
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Supposons que vous ayez un jeu qui fait faire beaucoup de calculs a l'ordinateur. Vous 
voulez que le jeu se mette en pause automatiquement lorsque la fenetre est reduite, et 
qu'il se relance lorsque la fenetre est restauree. Cela evite que le jeu continue pendant 
que le joueur n'est plus actif et cela evite aussi au processeur de faire trop de calculs 
par la meme occasion. 

Le code ci-dessous met en pause le jeu en activant un booleen pause a 1. II remet en 
marche le jeu en desactivant le booleen a 0. 

if ((event. active. state & SDL_APPACTIVE) == SDL_APPACTIVE) 
{ 

if (event .active. gain == 0) /* La fenetre a ete reduite */ 

pause = 1 ; 
else if (event .active. gain == 1) /* La fenetre a ete restauree */ 
pause = 0; 



} 
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Bien entendu, ce code nest pas complet. Ce sera a vous de tester I'etat de la 
variable pause pour savoir s'il faut ou non effectuer les calculs de votre jeu. 



Je vous laisse faire d'autres tests pour les autres cas (par exemple, verifier si le curseur 
de la souris est a l'interieur ou a l'exterieur de la fenetre). Vous pouvez — pour vous 
entrainer — faire bouger Zozor vers la droite lorsque la souris rentre dans la fenetre, 
et le faire bouger vers la gauche lorsqu'elle en sort. 



En resume 

- Les evenements sont des signaux que vous envoie la SDL pour vous informer d'une 
action de la part de l'utilisateur : appui sur une touche, mouvement ou clic de la 
souris, fermeture de la fenetre, etc. 

- Les evenements sont recuperes dans une variable de type SDL_Event avec la fonc- 
tion SDL_WaitEvent (fonction bloquante mais facile a gerer) ou avec la fonction 
SDL_PollEvent (fonction non bloquante mais plus complexe a manipuler). 

- II faut analyser la sous-variable event . type pour connaitre le type d'evenement qui 
s'est produit. On le fait en general dans un switch. 

- Une fois le type d'evenement determine, il est le plus souvent necessaire d'analyser 
l'evenement dans le detail. Par exemple, lorsqu'une touche du clavier a ete enfoncee 
(SDL_KEYD0WN) il faut analyser event .key.keysym. sym pour connaitre la touche en 
question. 

- Le double buffering est une technique qui consiste a charger l'image suivante en tache 
de fond et a 1'afHcher seulement une fois qu'elle est prete. Cela permet d'eviter des 
scintillements desagreables a l'ecran. 
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TP : Mario Sokoban 



La bibliotheque SDL fournit, comme vous I'avez vu, un grand nombre de fonctions 
pretes a I'emploi. II est facile de s'y perdre les premiers temps, surtout si on ne pratique 
pas. 

Ce premier TP de la section SDL est justement la pour vous faire decouvrir un cas pra- 
tique et surtout vous inviter a manipuler. Cette fois, vous I'aurez compris je crois, notre 
programme ne sera pas une console mais bel et bien une fenetre ! 

Quel va etre le sujet de ce TP? II va s'agir d'un jeu de Sokoban ! Peut-etre que ce nom 
ne vous dit rien, mais le jeu est pourtant un grand classique des casse-tetes. II consiste a 
pousser des caisses pour les amener a des points precis dans un labyrinthe. 
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Cahier des charges du Sokoban 
A propos du Sokoban 

« Sokoban » est un terme japonais qui signifie « Magasinier ». II s'agit d'un casse-tete 
invente dans les annees 80 par Hiroyuki Imabayashi. Le jeu a remporte un concours de 
programmation a cette epoque. 



Le but du jeu 

II est simple a comprendre : vous dirigez un personnage dans un labyrinthe. II doit 
pousser des caisses pour les amener a des endroits precis. Le joueur ne peut pas deplacer 
deux caisses a la fois. 

Si le principe se comprend vite et bien, cela ne veut pas dire pour autant que le jeu 
est toujours facile. II est en effet possible de realiser des casse-tetes vraiment. . . prise 
de tete ! 

La fig. 24.1 vous donne un apergu du jeu que nous allons realiser. 




Figure 24.1 - Le jeu Mario Sokoban que nous allons realiser 



Pourquoi avoir choisi ce jeu ? 

Parce que c'est un jeu populaire, qu'il fait un bon sujet de programmation et qu'on 
peut le realiser avec les connaissances que l'on a acquises. Alors bien sur, <ja demande 
de l'organisation. La difficulte n'est pas vraiment dans le code lui-meme mais dans 
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l'organisation. II va en effet falloir decouper notre programme en plusieurs fichiers . c 
intelligemment et essayer de creer les bonnes fonctions. 

C'est aussi pour cette raison que j'ai decide cette fois de ne pas construire le TP comme 
les precedents : je ne vais pas vous donner des indices suivis d'une correction a la fin. 
Au contraire, je vais vous montrer comment je realise tout le projet de A a Z. 




Kfl Et si je veux m'entramer tout seul ? 



Pas de probleme ! Allez-y lancez-vous, c'est meme tres bien ! II vous faudra certainement 
un peu de temps : personnellement ga m'a pris une bonne petite journee, et encore c'est 
parce que j'ai un peu l'habitude de programmer et que j'evite certains pieges courants 1 . 

Sachez qu'un tel jeu peut etre realise de nombreuses fagons differentes. Je vais vous 
montrer ma fagon de faire : ce n'est pas la meilleure, mais ce n'est pas la plus mauvaise 
non plus. Le TP se terminera par une serie de suggestions d' ameliorations et je vous 
proposerai de telecharger le code source complet bien entendu. 

Encore une fois : je vous conseille d'essayer de vous y lancer par vous-memes. Passez-y 
deux ou trois jours et faites de votre mieux. II est important que vous pratiquiez. 



Le cahier des charges 

Le cahier des charges est un document dans lequel on ecrit tout ce que le programme 
doit savoir faire. En l'occurence, que veut-on que notre jeu soit capable de faire? C'est 
le moment de se decider ! 

Void ce que je propose : 

- le joueur doit pouvoir se deplacer dans un labyrinthe et pousser des caisses ; 

- il ne peut pas pousser deux caisses a la fois ; 

- une partie est consideree comme gagnee lorsque toutes les caisses sont sur des objec- 
tifs ; 

- les niveaux de jeu seront enregistres dans un fichier (par exemple niveaux. lvl) ; 

- un editeur sera integre au programme pour que n'importe qui puisse creer ses propres 
niveaux 2 . 

Voila qui nous donnera bien assez de travail. 

A noter qu'il y a des choses que notre programme ne saura pas faire, ga aussi il faut le 
dire. 

- Notre programme ne pourra gerer qu'un seul niveau a la fois. Si vous voulez coder 
une « aventure » avec une suite de niveaux, vous n'aurez qu'a le faire vous-memes a 
la fin de ce TP. 

- II n'y aura pas de gestion du temps ecoule (on ne sait pas encore faire ga) ni du 



1. Cela ne m'a pas empeche de me prendre la tete a plusieurs reprises quand meme. ;-) 

2. Ce n'est pas indispensable mais ga ajoutera du piment ! 
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En fait, avec tout ce qu'on veut deja faire (notamment l'editeur de niveaux), il y en a 
pour un petit moment. 
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Je vous indiquerai a la fin du TP une liste d'idees pour ameliorer le programme. 
Et ce ne seront pas des paroles en I'air, car ce sont des idees que j'aurai moi- 
meme implementees dans une version plus complete du programme que je 
vous proposerai de telecharger. En revanche, je ne vous donnerai pas les 
codes source de la version complete pour vous forcer a travailler 3 . 



Recuperer les sprites du jeu 

Dans la plupart des jeux 2D, que ce soient des jeux de plate-forme ou de casse-tete 
comme ici, on appelle les images qui composent le jeu des sprites. Dans notre cas, 
j'ai decide qu'on creerait un Sokoban mettant en scene Mario (d'ou le nom « Mario 
Sokoban »). Comme Mario est un personnage populaire dans le monde de la 2D, on 
n'aura pas trop de mal a trouver des sprites de Mario. II faudra aussi trouver des sprites 
pour les murs de briques, les caisses, les objectifs, etc. 

Si vous faites une recherche sur Google pour « sprites », vous trouverez de nombreuses 
reponses. En effet, il y a beaucoup de sites qui proposent de telecharger des sprites de 
jeux 2D auxquels vous avez surement joue par le passe. 

Voici les sprites que nous allons utiliser : 



Sprite 


Description 


■ 


Un mur. 




Une caisse. 


■ 


Une caisse placee sur un objectif. 


• 


Un objectif (ou l'on doit placer une caisse). 


§ 


Le joueur (Mario) oriente vers le bas. 


f 


Mario vers la droite. 


1 


Mario vers la gauche. 


I 


Mario vers le haut. 



Le plus simple pour vous sera de telecharger un pack que j'ai prepare contenant toutes 
ces images. 

> ( Code web : 542566 ) 



3. Je vais pas tout vous servir sur un plateau d'argent non plus ! ;-) 
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Notez que j'aurais tres bien pu n'utiliser qu'un sprite pour le joueur. J'aurais 
pu faire en sorte que Mario soit toujours oriente vers le bas, mais le fait de 
pouvoir le diriger dans les quatre directions ajoute un peu plus de realisme. 
Ca ne fera qu'un petit defi de plus a relever I 



J'ai aussi cree une petite image qui pourra servir de menu d'accueil au lancement du 
programme (fig. 24.2), vous la trouverez dans le pack que vous venez normalement de 
telecharger. 



Mario Sokoban 



1 : jouer 

2 : editeur de niveaux 



r AA@teo21 pour mnrniiisiteduzero.com 



Figure 24.2 - L'ecran d'accueil du programme 



Vous noterez que les images sont dans differents formats. II y a des GIF, des PNG et des 
JPEG. Nous allons done avoir besoin de la bibliotheque SDL_Image. Pensez a configurer 
votre projet pour qu'il gere la SDL et SDL_Image. Si vous avez oublie comment faire, 
revoyez les chapitres precedents. Si vous ne configurez pas votre projet correctement, 
on vous dira que les fonctions que vous utilisez (comme IMG_Load) n'existent pas ! 



Le main et les constantes 



Chaque fois qu'on commence un projet assez important, il est necessaire de bien s'or- 
ganiser des le depart. En general, je commence par me creer un fichier de constantes 
constantes .h ainsi qu'un fichier main.c qui contiendra la fonction main (et unique- 
ment celle-la). Ce n'est pas une regie : e'est juste ma fagon de fonctionner. Chacun a 
sa propre maniere de faire. 
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Les differents fichiers du pro jet 

Je propose de creer des a present tous les fichiers du projet (meme s'ils restent vides 
au depart). Voici done les fichiers que je cree : 

- constantes.h : les definitions de constantes globales a tout le programme; 

- main . c : le fichier qui contient la fonction main (fonction principale du programme) ; 

- j eu . c : fonctions gerant une partie de Sokoban ; 

- jeu.h : prototypes des fonctions de jeu.c; 

- editeur.c : fonctions gerant l'editeur de niveaux ; 

- editeur.h : prototypes des fonctions de editeur.c; 

- fichiers. c : fonctions gerant la lecture et l'ecriture de fichiers de niveaux (comme 
niveaux . lvl par exemple) ; 

- fichiers. h : prototypes des fonctions de fichiers. c. 

On va commencer par creer le fichier des constantes. 

Les constantes : constantes.h 

Voici le contenu de mon fichier de constantes : 

/* 

constantes .h 



Par mateo21, pour Le Site du Zero (www.siteduzero.com) 

Role : definit des constantes pour tout le programme (taille de la fenetre...) 
*/ 

#ifndef DEF_CONSTANTES 
#define DEF_CONSTANTES 

#define TAILLE_BLOC 34 // Taille d'un bloc (carre) en pixels 

#define NB_BLOCS_LARGEUR 12 

#define NB_BLOCS_HAUTEUR 12 

#define LARGEUR_ FENETRE TAILLE_BLOC * NB_BLOCS_LARGEUR 

#define HAUTEUR_FEWETRE TAILLE_BLOC * NB_BLOCS_HAUTEUR 

enum {HAUT, BAS, GAUCHE, DROITE}; 

enum {VIDE, MUR, CAISSE, OBJECTIF, MARIO, CAISSE_OK}; 

#endif 

t> ( Code web : 250609 ) 

Vous noterez plusieurs points interessants dans ce petit fichier. 

- Le fichier commence par un commentaire d'en-tete. Je recommande de mettre ce 
type de commentaire au debut de chacun de vos fichiers (que ce soient des . h ou des 
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. c). Generalement, un commentaire d'en-tete contient : 

- le nom du fichier ; 

- l'auteur ; 

- le role du fichier (ce a quoi servent les fonctions qu'il contient) ; 

- je ne l'ai pas fait la, mais generalement, on met aussi la date de creation et la date 
de derniere modification. Qa permet de s'y retrouver, surtout dans les gros projets 
a plusieurs. 

- Le fichier est protege contre les inclusions infinies. II utilise la technique que l'on 
a apprise a la fin du chapitre sur le preprocesseur. Ici cette protection ne sert pas 
vraiment, mais j'ai pris l'habitude de faire ga pour chacun de mes fichiers .h sans 
exception. 

- Enfin, le cceur du fichier. Vous avez une serie de define. J'indique la taille d'un 
petit bloc en pixels (tous mes sprites sont des carres de 34 px). J'indique que ma 
fenetre comportera 12 x 12 blocs de largeur. Je calcule comme ga les dimensions de 
la fenetre par une simple multiplication des constantes. Ce que je fais la n'est pas 
obligatoire, mais a un enorme avantage : si plus tard je veux changer la taille du jeu, 
je n'aurai qu'a editer ce fichier (et a recompiler) et tout mon code source s'adaptera 
en consequence. 

- Enfin, j'ai defini d'autres constantes via des enumerations anonymes. C'est lege- 
rement different de ce qu'on a appris dans le chapitre sur les types de variables 
personnalises. Ici, je ne cree pas un type personnalise, je definis juste des constantes. 
Cela ressemble aux define a une difference pres : c'est l'ordinateur qui attribue au- 
tomatiquement un nombre a chacune des valeurs (en commengant par 0). Ainsi, on 
a HAUT = 0, BAS = 1, GAUCHE = 2, etc. Cela permettra de rendre notre code source 
beaucoup plus clair par la suite, vous verrez ! 

En resume, j 'utilise : 

- des define lorsque je veux attribuer une valeur precise a une constante (par exemple 
« 34 pixels ») ; 

- des enumerations lorsque la valeur attribuee a une constante ne m'importe pas. Ici, 
je me moque bien de savoir que HAUT vaut (ga pourrait aussi bien valoir 150, ga 
ne changerait rien) ; tout ce qui compte pour moi, c'est que cette constante ait une 
valeur differente de BAS, GAUCHE et DROITE. 



Inclure les definitions de constantes 

Le principe sera d'inclure ce fichier de constantes dans chacun de mes fichiers . c. Ainsi, 
partout dans mon code je pourrai utiliser les constantes que je viens de definir. 

II faudra done taper la ligne suivante au debut de chacun des fichiers . c : 



I # include "constantes .h" 
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Le main : main. c 

La fonction main principale est extremement simple. Elle a pour role d'afficher l'ecran 
d'accueil du jeu et de rediriger vers la bonne section. 

/* 

main . c 



Par mateo2l, pour Le Site du Zero (www.siteduzero.com) 

Role : menu du jeu. Permet de choisir entre l'editeur et le jeu lui-meme. 
*/ 

#include <stdlib.h> 

#include <stdio.h> 

#include <SDL/SDL.h> 

#include <SDL/SDL_image .h> 

#include "constantes .h" 
#include "jeu.h" 
#include "editeur.h" 

int main(int argc, char *argv[]) 
{ 

SDL_Surface *ecran = NULL, *menu = NULL; 

SDL_Rect positionMenu; 

SDL_Event event ; 

int continuer = 1 ; 
SDL_Init(SDL_INIT_VIDEO) ; 

SDL_WM_SetIcon(IMG_Load("caisse. jpg") , NULL); // L'icone doit etre chargee 
<-> avant SDL_SetVideoMode 

ecran = SDL_SetVideoMode(LARGEUR_FENETRE, HAUTEUR_FENETRE , 32, SDL_HWSURFACE 
^ I SDL_DOUBLEBUF) ; 

SDL_WM_SetCaption("Mario Sokoban", NULL); 

menu = IMG_LoadCmenu.jpg"); 
positionMenu. x = 0; 
positionMenu. y = 0; 

while (continuer) 
{ 

SDL_WaitEvent (ftevent) ; 
switch(event . type) 
{ 

case SDL_QUIT: 

continuer = 0; 
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break; 
case SDL_KEYDOWN: 

switch (event .key .keysym. sym) 
{ 

case SDLK_ESCAPE: // Veut arreter le jeu 
continuer = 0; 
break; 
case SDLK_KP1: // Demande a jouer 
jouer (ecran) ; 
break; 
case SDLK_KP2: // Demande l'editeur de niveaux 
editeur (ecran) ; 
break; 
} 

break; 
} 

// Effacement de 1' ecran 

SDL_FillRect (ecran, NULL, SDL_MapRGB(ecran->f ormat , 0, 0, 0)); 

SDL_BlitSurf ace (menu, NULL, ecran, ftpositionMenu) ; 

SDL_Flip (ecran) ; 



} 



SDL_FreeSurf ace (menu) ; 
SDL_Quit() ; 

return EXIT_SUCCESS; 



> Code web : 733369 



La fonction main se charge d'effectuer les initialisations de la SDL, de donner un titre 
a la fenetre ainsi qu'une icone. A la fin de la fonction, SDL_Quit() est appelee pour 
arreter la SDL proprement. 

La fonction affiche un menu. Le menu est charge en utilisant la fonction IMG_Load dc 
SDL_ Image : 

I menu = IMG_LoadCmenu.jpg"); 



Vous remarquerez que, pour donner les dimensions de la fenetre, j ' utilise les 
constantes LARGEUR_FENETRE et HAUTEUR_FENETRE qu'on a definies dans 

constantes . h. 




a 



La boucle des evenements 

La boucle infinie gere les evenements suivants : 
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- arret du programme (SDL_QUIT) : si on demande a former lc programme (clic sur 
la croix en haut a droite de la fenetre), alors on passe le booleen continuer a 0, et 
la boucle s'arretera. Bref, classique; 

- appui sur la touche Echap : arret du programme (comme SDL_QUIT) ; 

appui sur la touche 1 du pave numerique : lancement du jeu (appel de la 
fonction j ouer) ; 

appui sur la touche 2 du pave numerique : lancement de l'editeur (appel de la 
fonction editeur). 

Comme vous le voyez, e'est vraiment tres simple. Si on appuie sur 1, le jeu est lance. 
Une fois que le jeu est termine, la fonction jouer s'arrete et on retourne dans le main 
dans lequel on refait un tour de boucle. Le main boucle a l'infini tant qu'on ne demande 
pas a arreter le jeu. 

Grace a cette petite organisation tres simple, on peut done gerer le menu dans le main et 
laisser des fonctions speciales (comme jouer, ou editeur) gerer les differentes parties 
du programme. 



Le jeu 

Attaquons maintenant le gros du sujet : la fonction jouer! Cette fonction est la plus 
importante du programme, aussi soyez attentifs car e'est vraiment la qu'il faut com- 
prendre. Vous verrez apres que creer l'editeur de niveaux n'est pas si complique que <ja 
en a l'air. 



Les parametres envoyes a la fonction 

La fonction jouer a besoin d'un parametre : la surface ecran. En effet, la fenetre a 
ete ouverte dans le main, et pour que la fonction jouer puisse y dessiner, il faut qu'elle 
recupere le pointeur sur ecran! 

Si vous regardez le main a nouveau, vous voyez qu'on appelle jouer en lui envoyant 
ecran : 

I jouer (ecran) ; 

Le prototype de la fonction, que vous pouvez mettre dans jeu.h, est done le suivant : 

I void jouer (SDL_Surf ace* ecran); 



La fonction ne renvoie aucune valeur (d'ou le void), mais on pourrait en 
renvoyer une, si on voulait. On pourrait par exemple renvoyer un booleen 
pour dire si oui ou non on a gagne. 




a 
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Les declarations de variables 

Cette fonction va avoir besoin de nombreuses variables. Je n'ai pas pense a toutes les 
variables dont j'ai eu besoin du premier coup. II y en a done certaines que j'ai ajoutees 
par la suite. 

Variables de types definis par la SDL 

Voici pour commencer toutes les variables de types definis par la SDL dont j'ai besoin : 

SDL_Surface *mario[4] = {NULL}; // 4 surfaces pour 4 directions de mario 

SDL_Surface *mur = NULL, *caisse = NULL, *caisseOK = NULL, *objectif = NULL, 

<— > *marioActuel = NULL; 

SDL_Rect position, positionJoueur; 

SDL_Event event; 

J'ai cree un tableau de SDL_Surf ace appele mario. C'est un tableau de quatre cases 
qui stockera Mario dans chacune des directions (un vers le bas, un autre vers la gauche, 
vers le haut et vers la droite). 

II y a ensuite plusieurs surfaces correspondant a chacun des sprites que je vous ai fait 
telecharger plus haut : mur, caisse, caisseOK (une caisse sur un objectif) et objectif . 




"§> 



A quoi sert marioActuel ? 
O 



C'est un pointeur vers une surface. II pointe sur la surface correspondant au Mario 
oriente dans la direction actuelle. C'est done marioActuel que l'on blittera a l'ecran. 
Si vous regardez tout en bas de la fonction jouer, vous verrez justement : 

I SDL_BlitSurf ace (marioActuel, NULL, ecran, ftposition) ; 

On ne blitte done pas un element du tableau mario, mais le pointeur marioActuel. 
Ainsi, en blittant marioActuel, on blitte soit le Mario vers le bas, soit celui vers le 
haut, etc. Le pointeur marioActuel pointe vers une des cases du tableau mario. 

Quoi d'autre a part ga? Une variable position de type SDL_Rect dont on se servira 
pour definir la position des elements a blitter (on s'en servira pour tous les sprites, 
inutile de creer un SDL_Rect pour chaque surface!). positionJoueur est en revanche 
un peu differente : elle indique a quelle case sur la carte se trouve actuellement le 
joueur. Enfin, la variable event traitera les evenements. 

Variables plus « classiques » 

J'ai aussi besoin de me creer des variables un peu plus classiques de type int (entier). 
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int continuer = 1, objectif sRestants =0, i=0, j=0; 

int carte [NB_BLOCS_LARGEUR] [NB_BLOCS_HAUTEUR] = {0}; 

continuer et objectif sRestants sont des booleens. i et j sont des petites variables 
qui vont me permettre de parcourir le tableau carte. 

C'est la que les choses deviennent vraiment interessantes. J'ai en effet cree un tableau 
a deux dimensions. Je ne vous ai pas parle de ce type de tableaux auparavant 4 , mais 
c'est justement le moment ideal pour vous apprendre ce que c'est. Ce n'est pas bien 
complique, vous allez voir. 

Regardez la definition de plus pres : 

| int carte [WB_BLOCS_LARGEUR] [WB_BLOCS_HAUTEUR] = {0}; 

En fait, il s'agit d'un tableau d'int (entiers) qui a la particularite d'avoir deux paires 
de crochets [ ] . Si vous vous souvenez bien de constantes.h, NB_BLOCS_LARGEUR et 
NB_BLOCS_HAUTEUR sont des constantes qui valent toutes les deux 12. 

Ce tableau sera done a la compilation cree comme ceci : 



| int carte [12] [12] = {0}; 




<f 



Mais qu'est-ce que ca veut dire? 



Ca veut dire que pour chaque « case » de carte, il y a 12 sous-cases. II y aura done 
les variables suivantes : 

carte [0] [0] 
carte [0] [1] 
carte [0] [2] 
carte [0] [3] 
carte [0] [4] 
carte [0] [5] 
carte [0] [6] 
carte [0] [7] 
carte [0] [8] 
carte [0] [9] 
carte [0] [10] 
carte [0] [11] 
carte [1] [0] 
carte [1] [1] 
carte [1] [2] 
carte [1] [3] 



4. Je n'ai pas eu Foccasion d'en parler auparavant ; de plus, ajouter ces explications dans le chapitre 
sur les tableaux l'aurait rendu un peu indigeste. 
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carte [1] [4] 
carte [1] [5] 
carte [1] [6] 
carte [1] [7] 
carte [1] [8] 
carte [1] [9] 
carte [1] [10] 

carte [11] [2] 
carte [11] [3] 
carte [11] [4] 
carte [11] [5] 
carte [11] [6] 
carte [11] [7] 
carte [11] [8] 
carte [11] [9] 
carte [11] [10] 
carte [11] [11] 



C'est done un tableau de 12*12 = 144 cases ! Chacune des ces cases represente une 
case de la carte. 

La fig. 24.3 vous donne une idee de la fagon dont la carte est representee. 
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Figure 24.3 - Decoupage de la carte 
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Ainsi, la case en haut a gauche est stockee dans carte [0] [0] . La case en haut a droite 
est stockee dans carte [0] [11] . La case en bas a droite (la toute derniere) est stockee 
dans carte [11] [11]. 

Selon la valeur de la case (qui est un nombre entier) , on sait si la case contient un mur, 
une caisse, un objectif, etc.). C'est justement la que va servir notre enumeration de 
tout a l'heure ! 

|enum {VIDE, MUR, CAISSE, OBJECTIF, MARIO, CAISSE_0K}; 

Si la case vaut VIDE (0) on sait que cette partie de l'ecran devra rester blanche. Si elle 
vaut MUR (1), on sait qu'il faudra blitter une image de mur, etc. 

Initialisations 

Chargement des surfaces 

Maintenant qu'on a passe en revue toutes les variables de la fonction jouer, on peut 
commencer a faire quelques initialisations : 

// Chargement des sprites (decors, personnage. . . ) 
mur = IMG_Load("mur. jpg") ; 
caisse = IMG_LoadCcaisse.jpg"); 
caisseOK = IMG_LoadCcaisse_ok.jpg"); 
objectif = IMG_Load("objectif .png") ; 
mario[BAS] = IMG_Load("mario_bas .gif ") ; 
mario [GAUCHE] = IMG_Load("mario_gauche .gif ") ; 
mario[HAUT] = IMG_Load("mario_haut .gif ") ; 
mario [DROITE] = IMG_Load("mario_droite .gif ") ; 

Rien de sorcier la-dedans : on charge tout grace a IMG_Load. S'il y a une petite par- 
ticularity, c'est le chargement de mario. On charge en effet Mario dans chacune des 
directions dans le tableau mario en utilisant les constantes HAUT, BAS, GAUCHE, DROITE. 
Le fait d'utiliser les constantes rend ici — comme vous le voyez — le code plus clair. 
On aurait tres bien pu ecrire mario [0] , mais c'est quand mtae plus lisible d'avoir 
mario [HAUT] par exemple ! 

Orientation initiale du Mario (marioActuel) 

On initialise ensuite marioActuel pour qu'il ait une direction au depart : 

I marioActuel = mario [BAS]; // Mario sera dirige vers le bas au depart 

J'ai trouve plus logique de commencer la partie avec un Mario qui regarde vers le bas 
(c'est-a-dire vers nous). Si vous voulez, vous pouvez changer cette ligne et mettre : 

I marioActuel = mario [DROITE] ; 

Vous verrez que Mario sera alors oriente vers la droite au debut du jeu. 
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Chargement de la carte 

Maintenant, il va falloir remplir notre tableau a deux dimensions carte. Pour l'instant, 
ce tableau ne contient que des 0. II faut lire le niveau qui est stocke dans le fichier 
niveaux. lvl. 

// Chargement du niveau 
if ( !chargerNiveau( carte ) ) 

exit (EXIT_FAILURE) ; // On arrete le jeu si on n'a pas pu charger le niveau 

J'ai choisi de faire gerer le chargement (et l'enregistrement) de niveaux par des fonctions 
situees dans f ichiers . c. Ici, on appelle done la fonction chargerNiveau. On l'etudiera 
plus en details plus loin (elle n'est pas tres compliquee, de toute maniere). Tout ce qui 
nous interesse ici e'est de savoir que notre niveau a ete charge dans le tableau carte. 



o 



Si le niveau n'a pas pu etre charge (parce que niveaux. lvl n'existe pas), la 
fonction renverra « faux ». Sinon, elle renverra « vrai ». 



On teste done le resultat du chargement dans une condition. Si le resultat est negatif 
(d'ou le point d'exclamation qui sert a exprimer la negation), on arrete tout : on appelle 
exit. Sinon, e'est que tout va bien et on peut continuer. 

Nous possedons maintenant un tableau carte qui decrit le contenu de chaque case : 
MUR, VIDE, CAISSE. . . 

Recherche de la position de depart de Mario 

II faut maintenant initialiser la variable positionJoueur. Cette variable, de type 
SDL_Rect, est un peu particuliere. On ne s'en sert pas pour stocker des coordonnees 
en pixels. On s'en sert pour stocker des coordonnees en « cases » sur la carte. Ainsi, si 
on a : 

positionJoueur .x == 11 positionJoueur . y == 11 

. . . e'est que le joueur se trouve dans la toute derniere case en bas a droite de la carte. 
Reportez-vous au schema de la carte de la fig. 24.3 pour bien voir a quoi ca correspond 
si vous avez (deja) oublie. 

On doit parcourir notre tableau carte a deux dimensions a l'aide d'une double boucle. 
On utilise la petite variable i pour parcourir le tableau verticalement et la variable j 
pour le parcourir horizontalement : 

// Recherche de la position de Mario au depart 

for (i = ; i < NB_BLOCS_LARGEUR ; i++) 

{ 

for (j = ; j < NB_BLOCS_HAUTEUR ; j++) 

{ 

if (carte [i] [j] == MARIO) // Si Mario se trouve a cette position 
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positionJoueur .x = i; 
positionJoueur .y = j; 
carte [i] [j] = VIDE; 
} 
} 
} 

A chaque case, on teste si elle contient MARIO (c'est-a-dire le depart du joueur sur la 
carte). Si c'est le cas, on stocke les coordonnees actuelles (situees dans i et j) dans 
la variable positionJoueur. On efface aussi la case en la mettant a VIDE pour qu'elle 
soit consideree comme une case vide par la suite. 



Activation de la repetition des touches 

Derniere chose, tres simple : on active la repetition des touches pour qu'on puisse se 
deplacer sur la carte en laissant une touche enfoncee. 

// Activation de la repetition des touches 
SDL_EnableKeyRepeat(100, 100); 



La boucle principale 

Pfiou ! Nos initialisations sont faites, on peut maintenant s'occuper de la boucle prin- 
cipale. 

C'est une boucle classique qui fonctionne sur le meme schema que celles qu'on a vues 
jusqu'ici. Elle est juste un peu plus grosse et un peu plus complete (faut c'qui faut 
comme on dit !). 

Regardons de plus pres le switch qui teste l'evenement : 

switch (event . type) 
{ 

case SDL_QUIT: 

continuer = 0; 
break; 
case SDL_KEYD0WN: 

switch (event .key .keysym.sym) 
{ 

case SDLK_ESCAPE: 
continuer = 0; 
break ; 
case SDLK_UP: 

marioActuel = mario[HAUT]; 

deplacer Joueur ( carte, ftpositionJoueur, HAUT) ; 
break ; 
case SDLK_D0WN: 
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marioActuel = mario [BAS] ; 

deplacerJoueur (carte, ftpositionJoueur , BAS); 

break; 
case SDLK_RIGHT: 

marioActuel = mario [DROITE] ; 

deplacerJoueur (carte, ftpositionJoueur, DROITE) ; 

break; 
case SDLK_LEFT: 

marioActuel = mario [GAUCHE] ; 

deplacerJoueur (carte, ftpositionJoueur, GAUCHE) ; 

break; 



} 
break; 



Si on appuie sur la touche Echap, le jeu s'arretera et on retournera au menu principal. 

Comme vous le voyez, il n'y a pas 36 evenements differents a gerer : on teste juste si 
le joueur appuie sur les touches « haut », « bas », « gauche » ou « droite » de son 
clavier. Selon la touche enfoncee, on change la direction de Mario. C'est la qu'intervient 
marioActuel ! Si on appuie vers le haut, alors : 

I marioActuel = mario [HAUT] ; 

Si on appuie vers le bas, alors : 

I marioActuel = mario [BAS] ; 

marioActuel pointe done sur la surface representant Mario dans la position actuelle. 
C'est ainsi qu'en blittant marioActuel tout a l'heure, on sera certain de blitter Mario 
dans la bonne direction. 

Maintenant, chose tres importante : on appelle une fonction deplacerJoueur. Cette 
fonction va deplacer le joueur sur la carte s'il a le droit de le faire. 

- Par exemple, on ne peut pas faire monter Mario d'un cran vers le haut s'il se trouve 
deja tout en haut de la carte. 

- On ne peut pas non plus le faire monter s'il y a un mur au-dessus de lui. 

- On ne peut pas le faire monter s'il y a deux caisses au-dessus de lui. 

- Par centre, on peut le faire monter s'il y a juste une caisse au-dessus de lui. 

- Mais attention, on ne peut pas le faire monter s'il y a une caisse au-dessus de lui et 
que la caisse se trouve au bord de la carte ! 




<? 



Oh la la, c'est quoi ce bazar? 



C'est ce qu'on appelle la gestion des collisions. Si ga peut vous rassurer, ici c'est une 
gestion des collisions extremement simple, vu que le joueur se deplace par « cases » 
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et dans seulement quatre directions possibles a la fois. Dans un jeu 2D oil on peut se 
deplacer dans toutes les directions pixel par pixel, la gestion des collisions est bien plus 
complexe. 

Mais il y a pire : la 3D. La gestion des collisions dans un jeu 3D est vraiment la 
bete noire des programmeurs. Heureusement, il existe des bibliotheques de gestion des 
collisions en 3D qui font le gros du travail a notre place. 

Revenons a la fonction deplacerJoueur et concentrons-nous. On lui envoie trois para- 
metres : 

- la carte : pour qu'elle puisse la lire mais aussi la modifier, si on deplace une caisse 
par exemple ; 

- la position du joueur : la aussi, la fonction devra lire et eventuellement modifier la 
position du joueur ; 

- la direction dans laquelle on demande a aller : on utilise la encore les constantes 
HAUT, BAS, GAUCHE, DROITE pour plus de lisibilite. 

Nous ctudicrons la fonction deplacerJoueur plus loin. J'aurais tres bien pu mettre 
tous les tests dans le switch, mais celui-ci serait devenu enorme et illisible. C'est la 
que decouper son programme en fonctions prend tout son interet. 

Blittons, blittons, la queue du cochon 

Notre switch est termine : a ce stade du programme, la carte et le joueur ont proba- 
blement change. Quoi qu'il en soit, c'est l'heure du blit ! 

On commence par effacer l'ecran en lui donnant une couleur de fond blanche : 

// Effacement de l'ecran 

SDL_FillRect(ecran, NULL, SDL_MapRGB(ecran->f ormat , 255, 255, 255)); 

Et maintenant, on parcourt tout notre tableau a deux dimensions carte pour savoir 
quel element blitter a quel endroit sur l'ecran. On effectue une double boucle comme 
on l'a vu plus tot pour parcourir toutes les 144 cases du tableau : 

// Placement des objets a l'ecran 
objectif sRestants = 0; 

for (i = ; i < NB_BLOCS_LARGEUR ; i++) 
{ 

for (j = ; j < NB_BL0CS .HAUTEUR ; j++) 
{ 

position. x = i * TAILLE_BL0C; 
position. y = j * TAILLE_BL0C; 

switch(carte [i] [j] ) 
{ 

case MUR: 

SDL_BlitSurf ace(mur, NULL, ecran, ftposition) ; 
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break; 
case CAISSE: 

SDL_BlitSurface(caisse, NULL, ecran, ftposition) ; 
break; 
case CAISSE_0K: 

SDL_BlitSurface(caisseOK, NULL, ecran, ftposition) ; 
break; 
case OBJECTIF: 

SDL_BlitSurface(objectif , NULL, ecran, ftposition) ; 
objectif sRestants = 1; 
break; 
} 
} 
} 

Pour chacune des cases, on prepare la variable position (de type SDL_Rect) pour 
placer l'element actuel a la bonne position sur l'ecran. Le calcul est tres simple : 

position. x = i * TAILLE_BLOC; 
position. y = j * TAILLE_BLOC; 

II suffit de multiplier i par TAILLE_BLOC pour avoir position. x. Ainsi, si on se trouve 
a la troisieme case, c'est que i vaut 2 (n'oubliez pas que i commence a 0!). On fait 
done le calcul 2 * 34 = 68. On blittera done l'image 68 pixels vers la droite sur ecran. 
On fait la meme chose pour les ordonnees y. 

Ensuite, on fait un switch sur la case de la carte qu'on est en train d'analyser. La 
encore, avoir defini des constantes est vraiment pratique et rend les choses plus lisibles. 
On teste done si la case vaut MUR, dans ce cas on blitte un mur. De meme pour les 
caisses et les objectifs. 

Test de victoire 

Vous remarquerez qu'avant la double boucle, on initialise le booleen objectif sRestants 
a 0. Ce booleen sera mis a 1 des qu'on aura detecte un objectif sur la carte. S'il ne reste 
plus d'objectifs, c'est que toutes les caisses sont sur des objectifs (il n'y a plus que des 
CAISSE_0K). 

II suffit de tester si le booleen vaut « faux », e'est-a-dire s'il ne reste plus d'objectifs. 
Dans ce cas, on met la variable continuer a pour arreter la partie : 

// Si on n'a trouve aucun objectif sur la carte, c'est qu'on a gagne 
if (! objectif sRestants) 
continuer = 0; 

Le joueur 

II nous reste a blitter le joueur : 
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II On place le joueur a la bonne position 
position. x = positionJoueur .x * TAILLE_BLOC; 
position. y = positionJoueur .y * TAILLE_BLOC; 
SDL_BlitSurface(marioActuel, NULL, ecran, ^position) ; 

On calcule sa position (en pixels cette fois) en faisant une simple multiplication entre 
positionJoueur et TAILLE_BLOC. On blitte ensuite le joueur a la position indiquee. 

Flip! 

On a tout fait, il ne nous reste plus qu'a afficher l'ecran au joueur : 
| SDL_Flip (ecran) ; 

Fin de la fonction : dechargements 

Apres la boucle principale, on doit faire quelques FreeSurf ace pour liberer la memoire 
des sprites qu'on a charges. On desactive aussi la repetition des touches en envoyant 
les valeurs a la fonction SDL_EnableKeyRepeat : 

// Desactivation de la repetition des touches (remise a 0) 
SDL_EnableKeyRepeat(0, 0); 

// Liberation des surfaces chargees 
SDL_FreeSurface(mur) ; 
SDL_FreeSurface(caisse) ; 
SDL_FreeSurface(caisseOK) ; 
SDL_FreeSurface(objectif ) ; 
for (i = ; i < 4 ; i++) 

SDL_FreeSurf ace(mario[i] ) ; 

La fonction deplacerJoueur 

La fonction deplacerJoueur se trouve elle aussi dans jeu. c. C'est une fonction. . . assez 
delicate a ecrire. C'est peut-etre la principale difficulte que l'on rencontre lorsqu'on code 
un jeu de Sokoban. 

Rappel : la fonction deplacerJoueur verifie si on a le droit de deplacer le joueur dans 
la direction demandee. Elle met a jour la position du joueur (positionJoueur) et aussi 
la carte si une caisse a ete deplacee. 

Void le prototype de la fonction : 

| void deplacerJoueur (int carte [] [NB_BLOCS_HAUTEUR] , SDL_Rect *pos , int direction); 

Ce prototype est un peu particulier. Vous voyez que j'envoie le tableau carte et que 
je precise la taille de la deuxieme dimension (NB_BLOCS_HAUTEUR). Pourquoi cela? 
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La reponse est un peu compliquee pour que je la developpe au milieu de ce cours. Pour 
faire simple, le C ne devine pas qu'il s'agit d'un tableau a deux dimensions et il faut au 
moins donner la taille de la seconde dimension pour que <ja fonctionne. Done, lorsque 
vous envoyez un tableau a deux dimensions a une fonction, vous devez indiquer la taille 
de la seconde dimension dans le prototype. C'est comme <ja, e'est obligatoire. 

Autre chose : vous noterez que positionJoueur s'appelle en fait pos dans cette fonc- 
tion. J'ai choisi de raccourcir le nom parce que c'est plus court a ecrire, et vu qu'on va 
avoir besoin de l'ecrire de nombreuses fois, autant ne pas se fatiguer. 

Commengons par tester la direction dans laquelle on veut aller via un grand switch : 

switch (direct ion) 
{ 

case HAUT: 

/* etc. */ 



Et c'est parti pour des tests de folie ! 

II faut maintenant ecrire tous les tests de tous les cas possibles, en essayant de ne pas 
en oublier un seul. 

Voici comment je procede : je teste toutes les possibilites de collision cas par cas, et 
des que je detecte une collision (qui fait que le joueur ne peut pas bouger), je fais un 
break; pour sortir du switch, et done empecher le deplacement. 

Voici par exemple toutes les possibilites de collision qui existent pour un joueur qui 
veut se deplacer vers le haut : 

- le joueur est deja tout en haut de la carte ; 

- il y a un mur au-dessus du joueur ; 

- il y a deux caisses au-dessus du joueur (et il ne peut pas deplacer deux caisses a la 
fois, rappelez-vous) ; 

- il y a une caisse puis le bord de la carte. 

Si tous ces tests sont ok, alors je me permets de deplacer le joueur. 

Je vais vous montrer les tests pour un deplacement vers le haut. Pour les autres sens, 
il suffira d'adapter un petit peu le code. 

if (pos->y - 1 < 0) // Si le joueur depasse l'ecran, on arrete 
break ; 

On commence par verifier si le joueur est deja tout en haut de l'ecran. En effet, si 
on essayait d'appeler carte [5] [-1] par exemple, ce serait le plantage du programme 
assure ! On commence done par verifier qu'on ne va pas « deborder » de l'ecran. 

Ensuite : 

if (carte [pos->x] [pos->y - 1] == MUR) // S'il y a un mur, on arrete 
break ; 
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La encore c'est simple. On verifie s'il n'y a pas un mur au-dessus du joueur. Si tel est 
le cas, on arrete (break). 

Ensuite (attention les yeux) : 

// Si on veut pousser une caisse, il faut verifier qu'il n'y a pas de mur 

<—} derriere (ou une autre caisse, ou la limite du monde) 

if ( (carte [pos->x] [pos->y - 1] == CAISSE I I carte [pos->x] [pos->y - 1] == 

<->■ CAISSE_0K) && 

(pos->y - 2 < || carte [pos->x] [pos->y - 2] == MUR I I 

carte [pos->x] [pos->y - 2] == CAISSE I I carte [pos->x] [pos->y - 2] == 

^ CAISSE_0K)) 
break; 

Ce gros test peut se traduire comme ceci : « SI au-dessus du joueur il y a une caisse 
(ou une caisse_ok, c'est-a-dire une caisse bien placee) ET SI au-dessus de cette caisse 
il y a soit le vide (on deborde du niveau car on est tout en haut), soit une autre caisse, 
soit une caisse_ok : ALORS on ne peut pas se deplacer : break. » 

Si on arrive a passer ce test, on a le droit de deplacer le joueur. Ouf ! On appelle d'abord 
une fonction qui va deplacer une caisse si necessaire : 

// Si on arrive la, c'est qu'on peut deplacer le joueur ! 

// On verifie d'abord s'il y a une caisse a deplacer 

deplacerCaisse (&carte [pos->x] [pos->y - 1], ftcarte [pos->x] [pos->y - 2]); 



Le emplacement de caisse : deplacerCaisse 

J'ai choisi de gerer le deplacement de caisse dans une autre fonction car c'est le meme 
code pour les quatre directions. On doit juste s'etre assure avant qu'on a le droit de se 
deplacer (ce qu'on vient de faire). On envoie a la fonction deux parametres : le contenu 
de la case dans laquelle on veut aller et le contenu de la case d'apres. 

void deplacerCaisse (int *premiereCase, int *secondeCase) 
{ 

if (*premiereCase == CAISSE I I *premiereCase == CAISSE_0K) 
{ 

if (*secondeCase == OBJECTIF) 
*secondeCase = CAISSE_0K; 
else 

*secondeCase = CAISSE; 

if (*premiereCase == CAISSE_0K) 

*premiereCase = OBJECTIF; 
else 

*premiereCase = VIDE; 
} 
} 
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Cette fonction met a jour la carte car elle prend en parametres des pointeurs sur les 
cases concernees. Je vous laisse la lire, c'est assez simple a comprendre. II ne faut pas 
oublier que si on deplace une CAISSE_0K, il faut remplacer la case ou elle se trouvait par 
un OBJECTIF. Sinon, si c'est une simple CAISSE, alors on remplace la case en question 
par du VIDE. 

Deplacer le joueur 

On retourne dans la fonction deplacer Joueur. Cette fois c'est la bonne, on peut de- 
placer le joueur. 

Comment fait-on ? C'est tres tres simple : 

|pos->y--; // On peut enfin faire monter le joueur (oufff !) 

II suffit de diminuer l'ordonnee y (car le joueur veut monter). 

Resume 

En guise de resume, voici tous les tests pour le cas HAUT : 

switch (direct ion) 
{ 

case HAUT: 

if (pos->y - 1 < 0) //Si le joueur depasse l'ecran, on arrete 

break ; 
if (carte [pos->x] [pos->y - 1] == MUR) // S'il y a un mur, on arrete 

break ; 
// Si on veut pousser une caisse, il faut verifier qu'il n'y a pas de 
=->• mur derriere (ou une autre caisse, ou la limite du monde) 

if ( (carte [pos->x] [pos->y - 1] == CAISSE I I carte [pos->x] [pos->y - 1] == 
M> CAISSE_0K) kk 

(pos->y - 2 < || carte [pos->x] [pos->y - 2] == MUR I I 
carte [pos->x] [pos->y - 2] == CAISSE I I carte [pos->x] [pos->y - 2] == 
M> CAISSE_0K)) 

break ; 

// Si on arrive la, c'est qu'on peut deplacer le joueur ! 
// On verifie d'abord s'il y a une caisse a deplacer 
deplacerCaisse(&carte [pos->x] [pos->y - 1], ftcarte [pos->x] [pos->y -2]); 

pos->y--; // On peut enfin faire monter le joueur (oufff !) 
break; 

Je vous laisse le soin de faire du copier-coller pour les autres cas (attention, il faudra 
adapter le code, ce n'est pas exactement pareil a chaque fois !). 
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Et voila, on vient de finir de coder le jeu ! Enfin presque : il nous reste a voir la 
fonction de chargement (et de sauvegarde) de niveaux. On verra ensuite comment 
creer l'editeur 5 . 



Chargement et enregistrement de niveaux 

Le fichier fichiers.c contient deux fonctions : 

- chargerNiveau ; 

- sauvegarderNiveau. 

Commengons par le chargement de niveau. 



chargerNiveau 

Cette fonction prend un parametre : la carte. La encore, il faut preciser la taille de la 
seconde dimension car il s'agit d'un tableau a deux dimensions. La fonction renvoie un 
booleen : « vrai » si le chargement a reussi, « faux » si c'est un echec. 

Le prototype est done : 

| int chargerNiveau (int niveau [] [NB_BLOCS_HAUTEUR] ) ; 

Voyons le debut de la fonction : 

FILE* fichier = NULL; 

char ligneFichier[NB_BLOCS_LARGEUR * NB_BLOCS_HAUTEUR + 1] = {0}; 

int i = , j = ; 

fichier = f open ("niveaux. lvl" , "r"); 
if (fichier == NULL) 
return 0; 

On cree un tableau de char pour stocker temporairement le resultat du chargement du 
niveau. On ouvre le fichier en lecture seule ("r"). On arrete la fonction en renvoyant 
(« faux ») si l'ouverture a echoue. Classique. 

Le fichier niveaux . lvl contient une ligne qui est une suite de nombres. Chaque nombre 
represente une case du niveau. Par exemple : 

| 11111001111111111400000111110001100103310101101100000200121110 [. . .] 

On va done lire cette ligne avec un f gets : 

|fgets(ligneFichier, NB_BL0CS_LARGEUR * NB_BL0CS .HAUTEUR + 1, fichier); 



5. Rassurez-vous, ga ira bien plus vite ! 
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On va analyser le contenu de ligneFichier. On sait que les 12 premiers caracteres 
representent la premiere ligne, les 12 suivants la seconde ligne, etc. 



for (i = 


; i < NB_BLOCS_LARGEUR ; i++) 


{ 






for (j 


= ; j < WB_BL0CS_ 


HAUTEUR ; j++) 


{ 






switch (ligneFichier [( 


i * NB_BLOCS_LARGEUR) + j]) 


{ 


case '0': 






niveau [j] [i] = 


0; 




break; 






case '1' : 






niveau [j] [i] = 


l; 




break; 






case '2' : 






niveau [j] [i] = 


2; 




break; 






case '3' : 






niveau [j] [i] = 


3; 




break; 






case >4>: 






niveau [j] [i] = 


4; 




break; 




} 






} 







Par un simple petit calcul, on prend le caractere qui nous interesse dans ligneFichier 
et on analyse sa valeur. 



A 



Ce sont des « lettres » qui sont stockees dans le fichier. Je veux dire par la 
que '0' est stocke comme le caractere ASCII '0', et sa valeur n'est pas I 
Pour analyser le fichier, il faut tester avec case '0' et non avec case I 
Attention a ne pas melanger les chiffres et les lettres I 



Le switch fait la conversion '0' => 0, '1' => 1, etc. II place tout dans le tableau 
carte 6 . 

Une fois que c'est fait, on peut fermer le fichier et renvoyer 1 pour dire que tout s'est 
bien passe : 

f close (fichier) ; 
return 1 ; 

Finalement, le chargement du niveau dans le fichier n'etait pas bien complique. Le seul 
piege a eviter c'etait de bien penser a convertir la valeur ASCII '0' en un nombre 
(et de meme pour 1, 2, 3, 4. . .). 



6. La carte s'appelle niveau dans cette fonction d'ailleurs, mais ga ne change rien. 
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sauvegarderNiveau 

Cette fonction est la encore simple : 

int sauvegarderNiveau (int niveau [] [NB_BLOCS_HAUTEUR] ) 
{ 

FILE* fichier = NULL; 

int i = , j = ; 

fichier = f open("niveaux. lvl" , "w") ; 
if (fichier == NULL) 
return ; 

for (i = ; i < NB_BLOCS_LARGEUR ; i++) 
{ 

for (j = ; j < NB_BLOCS_HAUTEUR ; j++) 

{ 

fprintf (fichier, "'/,d" , niveau [j] [i] ) ; 

} 
} 

f close (fichier) ; 
return 1 ; 



J'utilise fprintf pour « traduire » les nombres du tableau niveau en caracteres ASCII. 
C'etait la encore la seule difficulte (mais a l'envers) : il ne faut pas ecrire mais '0'. 



L'editeur de niveaux 

L'editeur de niveaux est plus facile a creer qu'on ne pourrait l'imaginer. En plus c'est 
une fonctionnalite qui va considerablement allonger la duree de vie de notre jeu, alors 
pourquoi s'en priver ? 

Voila comment l'editeur va fonctionner. 

- On utilise la souris pour placer les blocs qu'on veut sur l'ecran. 

- Un clic droit efface le bloc sur lequel se trouve la souris. 

- Un clic gauche place un objet. Cet objet est memorise : par defaut, on pose des murs 
avec le clic gauche. On peut changer l'objet en cours en appuyant sur les touches du 
pave numerique : 

- 1 : mur, 

- 2 : caisse, 

- 3 : objectif, 

- 4 : depart du joueur Mario. 

- En appuyant sur S, le niveau sera sauvegarde. 

- On peut revenir au menu principal en appuyant sur Echap. 
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Figure 24.4 - Edition d'un niveau avec l'editeur 

Initialisations 

Globalement , la fonction ressemble a celle du jeu. J'ai d'ailleurs commence a la creer en 
faisant un simple copier-coller de la fonction de jeu, puis en enlevant ce qui ne servait 
plus et en ajoutant de nouvelles fonctionnalites. 

Le debut y ressemble deja pas mal : 



void editeur (SDL_Surf ace* ecran) 
{ 

SDL_Surface *mur = NULL, *caisse = NULL, *objectif = NULL, *mario = NULL; 

SDL_Rect position; 

SDL_Event event ; 

int continuer = 1, clicGaucheEnCours = 0, clicDroitEnCours = 0; 

int objetActuel = MUR, i = 0, j =0; 

int carte [NB_BLOCS_LARGEUR] [NB_BL0CS .HAUTEUR] = {0}; 

// Chargement des objets et du niveau 
mur = IMG_LoadCmur.jpg"); 
caisse = IMG_Load("caisse . jpg") ; 
objectif = IMG_Load("objectif .png") ; 
mario = IMG_LoadCmario_bas.gif"); 

if (! chargerNiveau (carte) ) 
exit (EXIT_FAILURE) ; 
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La, vous avez les definitions de variables et les initialisations. Vous remarquerez que je 
ne charge qu'un Mario (celui dirige vers le bas). En effet, on ne va pas diriger Mario 
au clavier la, on a juste besoin d'un sprite representant la position de depart de Mario. 

La variable objetActuel retient l'objet actuellement selectionne par l'utilisateur. Par 
defaut, c'est un MUR. Le clic gauche creera done un mur au depart, mais cela pourra 
etre change par l'utilisateur en appuyant sur 1, 2, 3 ou 4. 

Les booleens clicGaucheEnCours et clicDroitEnCours, comme leurs noms l'indiquent, 
permettent de memoriser si un clic est en cours (si le bouton de la souris est enfonce). 
Cela nous permettra de poser des objets a l'ecran en laissant le bouton de la souris 
enfonce 7 . Je vous expliquerai le principe un peu plus loin. 

Enfin, la carte actuellement sauvegardee dans niveaux . lvl est chargee. Ce sera notre 
point de depart. 

La gestion des evenements 

Cette fois, on va devoir gerer un nombre important d'evenements differents. Allons-y, 
un par un. 

SDL_QUIT 

case SDL_QUIT: 

continuer = 0; 
break; 

Si on clique sur la croix, la boucle s'arrete et on revient au menu principal 8 . 

SDL_M0USEBUTT0ND0WN 

case SDL_M0USEBUTT0ND0WN: 

if (event. button. button == SDL_BUTTON_LEFT) 
{ 

// On met l'objet actuellement choisi (mur, caisse...) a l'endroit du 
<^-> clic 

carte [event. button. x / TAILLE_BL0C] [event .button. y / TAILLE_BL0C] = 
<—} objetActuel; 

clicGaucheEnCours = 1; //On retient qu'un bouton est enfonce 
} 

else if (event. button. button == SDL_BUTTON_RIGHT) // Clic droit pour ef facer 
{ 



7. Sinon on est oblige de cliquer frenetiquement avec la souris pour placer plusieurs fois le meme 
objet a differents endroits, ce qui est un peu fatigant. 

8. Notez que ce n'est pas ce qu'il y a de plus ergonomique pour l'utilisateur : celui-ci s'attend plutot 
a ce que le programme s'arrete quand on clique sur la croix, or ce n'est pas ce qu'il se passe ici car 
on ne fait que revenir au menu. II faudrait peut-etre trouver un moyen d'arreter le programme en 
renvoyant une valeur speciale a la fonction main par exemple. Je vous laisse reflechir a une solution. 
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carte[event. button. x / TAILLE_BLOC] [event .button. y /TAILLE_BLOC] = VIDE; 

clicDroitEnCours = 1; 
} 
break ; 

On commence par tester le bouton qui est enfonce (on verifie si c'est le clic gauche ou 
le clic droit) : 

- si c'est un clic gauche, on place 1'objetActuel sur la carte a la position de la souris ; 

- si c'est un clic droit, on efface ce qu'il y a a cet endroit sur la carte (on met VIDE 
comme je vous avais dit). 



Comment sait-on sur quelle « case » de la carte on se trouve? 



On le retrouve grace a un petit calcul. II sufRt de prendre les coordonnees de la sou- 
ris (event .button. x par exemple) et de diviser cette valeur par la taille d'un bloc 
(TAILLE_BLOC). C'est une division de nombres entiers. Comme en C une division de 
nombres entiers donne un nombre entier, on est sur d'avoir une valeur qui corresponde 
a une des cases de la carte. 

Par exemple, si je suis au 75 e pixel sur la carte (sur l'axe des abscisses x), je divise ce 
nombre par TAILLE_BLOC qui vaut ici 34. 

75 / 34 = 2 

N'oubliez pas que le reste est ignore. On ne garde que la partie entiere de la division 
en C car il s'agit d'une divison de nombres entiers. On sait done qu'on se trouve sur la 
case n°2 (e'est-a-dire la troisieme case, car un tableau commence a 0, souvenez-vous). 

Autre exemple : si je suis au 10 e pixel (e'est-a-dire tres proche du bord), ca va donner 
le calcul suivant : 

10 / 34 = 

On est done a la case n°0 ! 

C'est comme 5a qu'un simple petit calcul nous permet de savoir sur quelle case de la 
carte on se situe. 

I carte[event. button. x / TAILLE_BL0C] [event .button. y / TAILLE_BL0C] = objetActuel; 

Autre chose tres importante : on met un booleen clicGaucheEnCours (ou clicDroit 
selon le cas) a 1. Cela nous permettra de savoir lors d'un evenement M0USEM0TI0N si 
un bouton de la souris est enfonce pendant le deplacement. 

SDL_M0USEBUTT0NUP 

case SDL_M0USEBUTT0NUP : // On desactive le booleen qui disait qu'un bouton etait 
<— > enfonce 
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if (event. button. button == SDL_BUTTON_LEFT) 

clicGaucheEnCours = 0; 
else if (event. button. button == SDL_BUTTON_RIGHT) 

clicDroitEnCours = 0; 
break; 



L'evenement M0USEBUTT0NUP sert simplement a remettre le booleen a 0. On sait que le 
clic est termine et done qu'il n'y a plus de « clic en cours ». 



SDL_M0USEM0TI0N 

case SDL_M0USEM0TI0N: 

if (clicGaucheEnCours) // Si on deplace la souris et que le bouton gauche de 
<— ¥ la souris est enfonce 

{ 

carte [event .motion. x / TAILLE_BL0C] [event .motion. y / TAILLE_BL0C] = 
<—} objetActuel; 

} 

else if (clicDroitEnCours) // Pareil pour le bouton droit de la souris 

{ 

carte [event. motion. x / TAILLE_BL0C] [event .motion. y / TAILLE_BL0C] = VIDE; 

} 

break; 



C'est la que nos booleens prennent toute leur importance. On verifie quand on bouge 
la souris si un clic est en cours. Si tel est le cas, on place sur la carte un objet (ou du 
vide si c'est un clic droit). Cela nous permet done de placer d'affilee plusieurs objets 
du meme type sans avoir a cliquer plusieurs fois. On a juste a deplacer la souris en 
maintenant son bouton enfonce ! 

En clair : a chaque fois qu'on bouge la souris (ne serait-ce que d'un pixel), on verifie si 
un des booleens est active. Si tel est le cas, alors on pose un objet sur la carte. Sinon, 
on ne fait rien. 

Resume : je resume la technique, car vous vous en servirez certainement dans d'autres 
programmes. Cette technique permet de savoir si un bouton de la souris est enfonce 
lorsqu'on la deplace. On peut s'en servir pour coder un glisser-deplacer. 

1. Lors d'un M0USEBUTT0ND0WN : on met un booleen clicEnCours a 1. 

2. Lors d'un M0USEM0TI0N : on teste si le booleen clicEnCours vaut « vrai ». S'il 
vaut « vrai », on sait qu'on est en train de faire une sorte de glisser-deplacer avec 
la souris. 

3. Lors d'un MOUSEBUTTONUP : on remet le booleen clicEnCours a 0, car le clic est 
termine (relachement du bouton de la souris). 
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SDL_KEYDOWN 

Les touches du clavier permettent de charger et de sauvegarder le niveau ainsi que de 
changer l'objet actuellement selectionne pour le clic gauche de la souris. 

case SDL_KEYDOWN: 

switch (event .key .keysym.sym) 
{ 

case SDLK_ESCAPE: 

continuer = 0; 

break ; 
case SDLK_s : 

sauvegarderNiveau(carte) ; 

break ; 
case SDLK_c : 

chargerNiveau(carte) ; 

break ; 
case SDLKJCP1: 

objetActuel = MUR; 

break ; 
case SDLK_KP2: 

objetActuel = CAISSE; 

break ; 
case SDLKJCP3: 

objetActuel = OBJECTIF; 

break ; 
case SDLKJCP4: 

objetActuel = MARIO; 

break ; 
} 
break ; 

Ce code est tres simple. On change l'objet actuel si on appuie sur une des touches 
numeriques, on enregistre le niveau si on appuie sur S, ou on charge le dernier niveau 
enregistre si on appuie sur C. 

Blit time ! 

Voila : on a passe en revue tous les evenements. Maintenant, on n'a plus qu'a blitter 
chacun des elements de la carte a l'aide d'une double boucle. C'est a peu de choses pres 
le mtae code que celui de la fonction de jeu. Je vous le redonne, mais pas la peine de 
vous le reexpliquer ici. 

// Effacement de l'ecran 

SDL_FillRect(ecran, NULL, SDL_MapRGB(ecran->f ormat , 255, 255, 255)); 

// Placement des objets a l'ecran 

for (i = ; i < NB_BLOCS_LARGEUR ; i++) 
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for (j = ; j < NB_BL0CS .HAUTEUR ; j++) 
{ 

position. x = i * TAILLE_BLOC; 

position. y = j * TAILLE_BLOC; 

switch(carte [i] [j] ) 
{ 

case MUR: 

SDL_BlitSurf ace(mur, NULL, ecran, ftposition) ; 

break ; 
case CAISSE: 

SDL_BlitSurf ace(caisse, NULL, ecran, ftposition) ; 

break ; 
case OBJECTIF: 

SDL_BlitSurf ace(objectif , NULL, ecran, ftposition) ; 

break ; 
case MARIO: 

SDL_BlitSurf ace(mario, NULL, ecran, ftposition) ; 

break ; 



// Mise a jour de 1' ecran 
SDL_Flip (ecran) ; 

II ne faut pas oublier apres la boucle principale de faire les SDL_FreeSurf ace qui 
s'imposent : 

SDL_FreeSurface(mur) ; 
SDL_FreeSurface(caisse) ; 
SDL_FreeSurface(objectif ) ; 
SDL_FreeSurface(mario) ; 

Avec ga, le menage est fait. :-) 

Resume et ameliorations 

Bien, on a fait le tour. L'heure est au resume. 

Alors resumons ! 

Et quel meilleur resume pourrait-on imaginer que le code source complet du programme 
avec les comment aires ? 
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Pour eviter de vous proposer des dizaines de pages de code qui repetent tout ce qu'on 
vient de voir, je vous propose plutot de telecharger le code source complet du pro- 
gramme ainsi que l'executable 9 . 

> ( Code web : 789039 ) 
Ce fichier .zip contient : 

- l'executable pour Windows (si vous etes sous un autre OS, il suffira de recompiler) ; 

- les DLL de la SDL et de SDL_Image ; 

- toutes les images dont a besom le programme (je vous les ai fait telecharger plus tot 
dans le pack « sprites ») ; 

- les sources completes du programme ; 

- le fichier . cbp de projet Code: :Blocks. Si vous voulez ouvrir le projet sous un autre 
IDE, creez un nouveau projet de type SDL (configurez-le correctement pour la SDL) 
et ajoutez-y manuellement tous les fichiers . c et .h. Ce n'est pas bien complique, 
vous verrez. 

Vous noterez que le projet contient, en plus des . c et des . h, un fichier ressources . re. 
C'est un fichier qui peut etre ajoute au projet (uniquement sous Windows) et qui 
permet d'integrer des fichiers dans l'executable. Ici, je me sers du fichier de ressources 
pour integrer une icone dans l'executable. Cela aura pour effet de donner une icfine a 
l'executable, visible dans l'explorateur Windows (fig. 24.5). 



ma no sokoban 



Fichier Edition AFFichage Favoris Outils ? 
rj Precedente " CJ T i LJ Rechercher 



|& C:\Documents and 5ettings\Mateo21\Mes documents\5ites\5dZ - Ecriture\C-C++\tests\mario_sokoban 

j inidgu bp — 




Figure 24.5 - Integration d'une icone a l'executable 

Avouez que c'est quand meme plus sympa que d'avoir l'icone par defaut de Windows 
pour les executables ! 

Vous trouverez plus d'informations sur cette technique sur le Site du Zero. 

> ( Code web : 862237) 

9. Compile pour Windows. 
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Ameliorez ! 

Ce programme n'est pas parfait, loin de la! Vous voulez des idees pour l'ameliorer? 

- II manque un mode d'emploi. Affichez un ecran d'explications juste avant le lan- 
cement d'une partie et avant le lancement de l'editeur. Indiquez en particulier les 
touches a utiliser. 

- Dans l'editeur de niveaux, on ne sait pas quel est l'objet actuellement selectionne. Ce 
qui serait bien, c'est que l'objet actuellement selectionne suive le curseur de la 
souris. Comme ga, l'utilisateur verrait ce qu'il s'apprete a mettre sur la carte. C'est 
facile a faire : on a deja fait un Zozor qui suit le curseur de la souris dans le chapitre 
precedent ! 

- Dans l'editeur de niveaux, on apprecierait de pouvoir choisir une CAISSE_OK 
(une caisse bien placee sur un objectif des le depart). En effet, je me suis rendu 
compte par la suite qu'il y a de nombreux niveaux qui commencent avec des caisses 
bien placees des le depart (ga ne veut pas dire que le niveau est plus facile, loin de 
la). 

Dans l'editeur toujours, il faudrait empecher que l'on puisse placer plus d'un 
depart de joueur sur une meme carte ! 

- Lorsqu'on reussit un niveau, on retourne immediatement au menu. C'est un peu brut. 
Que diriez-vous d'afflcher un message « Bravo » au centre de l'ecran quand on 
gagne ? 

- Enfin, il serait bien que le programme puisse gerer plus d'un niveau a la fois. II 
faudrait que l'on puisse creer une veritable petite aventure d'une vingtaine 
de niveaux par exemple. C'est un petit peu plus complique a coder mais faisable. 
II faudra adapter le jeu et l'editeur de niveaux en consequence 10 . 

Comme promis, pour vous prouver que c'est faisable. . . je l'ai fait ! Je ne vous donne 
pas le code source, en revanche (je crois que je vous en ai deja assez donne jusqu'ici !), 
mais je vous donne le programme complet compile pour Windows et Linux. 

Le programme comporte une aventure de 20 niveaux (de tres tres facile a. . . super 
difficile). Pour realiser certains de ces niveaux, je me suis base sur le site d'un passionne 
de Sokoban (sokoban.online.fr). 

Pour telecharger le Mario Sokoban ameliore pour Windows 11 : 



> ( Code web : 401636 ) 

Et pour telecharger la version Linux : 

> ( Code web : 630715 ) 



10. Je vous suggere de mettre un niveau par ligne dans niveaux. lvl. 

11. Le programme d'installation a ete cree a l'aide d'Inno Setup. Pour plus d'informations, voir 
Fannexe du Site du Zero (code web : 851504) 
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aTtrisez le temps ! 



Difficulty : WB 

Ce chapitre est d'une importance capitale : il va vous apprendre a controler le temps 
en SDL. II est rare que Ton cree un programme SDL sans faire appel aux fonctions 
de gestion du temps, bien que le TP Mario Sokoban constitue un contre-exemple. II 
n'en reste pas moins que pour la majorite des jeux, la gestion du temps est fondamentale. 

Par exemple, comment vous y prendriez-vous pour realiser un Tetris ou un Snake (jeu du 
serpent)? II faut bien que les blocs bougent toutes les X secondes, ce que vous ne savez 
pas faire. Du moins, pas avant d'avoir lu ce chapitre. ;-) 
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Le Delay et les ticks 



Dans un premier temps, nous allons apprendre a utiliser deux fonctions tres simples : 

- SDL_Delay : permet de mettre en pause le programme un certain nombre de millise- 
condes ; 

- SDL_GetTicks : retourne le nombre de millisecondes ecoulees depuis le lancement du 
programme. 

Ces deux fonctions sont tres simples comme nous allons le voir, mais bien les utiliser 
n'est pas si evident que <ja en a l'air. . . 

SDL.Delay 

Cette fonction effectue une pause sur le programme durant un certain temps. Pendant 
que le programme est en pause, on dit qu'il dort (« sleep » en anglais) : il n'utilise pas 
le processeur. 

SDL_Delay peut done etre utilisee pour reduire l'utilisation du processeur 1 . Grace a 
SDL_Delay, vous pourrez rendre votre programme moins gourmand en ressources pro- 
cesseur. II fera done moins « ramer » votre PC si SDL_Delay est utilisee intelligemment. 

Tout depend du programme que vous creez : parfois, on aimerait bien que 
notre programme utilise le moins de CPU possible pour que I'utilisateur puisse 
faire autre chose en meme temps, comme e'est le cas pour un lecteur MP3 
qui tourne en fond pendant que vous naviguez sur Internet. Mais. . . d'autres 
fois, on se moque completement que notre programme utilise tout le temps 
100 % de CPU. C'est le cas de la quasi-totalite des jeux. 




a 



Revenons a la fonction qui nous interesse. Son prototype est d'une simplicite desolante : 

| void SDL_Delay(Uint32 ms) ; 

En clair, vous envoyez a la fonction le nombre de millisecondes pendant lesquelles votre 
programme doit « dormir ». C'est une simple mise en pause. 

Par exemple, si vous voulez que votre programme se mette en pause 1 seconde, vous 
devrez ecrire : 

| SDL_Delay(1000) ; 

N'oubliez pas que ce sont des millisecondes : 

- 1000 millisecondes = 1 seconde ; 

- 500 millisecondes = 1/2 seconde ; 

- 250 millisecondes = 1/4 seconde. 

1. Notez que j'abregerai CPU, desormais. C'est une abreviation courante qui signifie Central Pro- 
cessing Unit, soit « Unite centrale de calcul ». 
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Vous ne pouvez rien faire dans votre programme pendant qu'il est en pause ! 
Un programme qui « dort » ne peut rien faire puisqu'il n'est pas actif pour 

I'ordinateur. 



Le probleme de la granularite du temps 

Non, rassurez-vous, je ne vais pas vous faire un traite de physique quantique au beau 
milieu d'un chapitre SDL! Toutefois, j'estime qu'il y a quelque chose que vous devez 
savoir : SDL_Delay n'est pas une fonction « parfaite ». Et ce n'est pas de sa faute, c'est 
la faute de votre OS (Windows, Linux, Mac OS X. . .). 

Pourquoi l'OS intervient-il la-dedans ? Tout simplement parce que c'est lui qui controle 
les programmes qui tournent ! Votre programme va done dire a l'OS : « Je dors, reveille- 
moi dans 1 seconde ». Mais l'OS ne va pas forcement le reveiller exactement au bout 
d'une seconde. 

En effet, il aura peut-etre un peu de retard (un retard de 10 ms en moyenne environ, 
<ja depend des PC). Pourquoi? Parce que votre CPU ne peut travailler que sur un 
programme a la fois. Le role de l'OS est de dire au CPU ce sur quoi il doit travailler : 
« Alors, pendant 40 ms tu vas travailler sur firefox.exe, puis pendant 110 ms sur 
explorer.exe; ensuite, pendant 80 ms tu vas travailler sur programme_sdl.exe, puis 
retravailler sur f iref ox . exe pendant 65 ms », etc. L'OS est le veritable chef d'orchestre 
de I'ordinateur ! 

Maintenant, imaginez qu'au bout d'une seconde un autre programme soit encore en 
train de travailler : il faudra qu'il ait fini pour que votre programme puisse « reprendre 
la main » comme on dit, e'est-a-dire etre traite a nouveau par le CPU. 

Qu'est-ce qu'il faut retenir ? Que votre CPU ne peut pas gerer plus d'un programme a 
la fois 2 . Pour donner l'impression que l'on peut faire tourner plusieurs programmes en 
meme temps sur un ordinateur, l'OS « decoupe » le temps et autorise les programmes 
a travailler tour a tour. 

Or, cette gestion des programmes est tres complexe et on ne peut done pas avoir la 
garantie que notre programme sera reveille au bout d'une seconde exactement. 

Toutefois, cela depend des PC comme je vous l'ai dit plus haut. Chez moi, j'ai pu 
constater que la fonction SDL_Delay etait assez precise. 

A cause de ce probleme de granularite du temps, vous ne pouvez done pas 
mettre en pause votre programme pendant un temps trop court. Par exemple, 
si vous faites : 



O 




a 



SDL_Delay(l); 

. . . vous pouvez etre certains que votre programme ne sera pas mis en pause 
1 ms mais un peu plus (peut-etre 9-10 ms). 



2. C'est toutefois de moins en moins vrai. Les CPU double coeur ont en effet la capacite de travailler 
sur deux programmes a la fois, maintenant. 
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SDL_Delay est done bien pratique, mais ne lui faites pas trop confiance. Elle ne mettra 
pas en pause votre programme pendant le temps exact que vous indiquez. Ce n'est pas 
parce que la fonction est mal codee, e'est parce que le fonctionnement d'un ordinateur 
est tres complexe et ne permet pas d'etre tres precis a ce niveau. 

SDL.GetTicks 

Cette fonction renvoie le nombre de millisecondes ecoulees depuis le lancement du 
programme. C'est un indicateur de temps indispensable. Cela vous permet de vous 
reperer dans le temps, vous allez voir ! 

Voici le prototype : 

|Uint32 SDL_GetTicks(void) ; 

La fonction n'attend aucun parametre, elle renvoie juste le nombre de millisecondes 
ecoulees. Ce nombre augmente au fur et a mesure que le temps passe, inlassablement. 
Pour info, la doc' de la SDL indique que le nombre atteint son maximum et est re- 
initialise au bout de 49 jours ! A priori votre programme SDL devrait tourner moins 
longtemps que <ja, done pas de souci de ce cote-la. 

Utiliser SDL_GetTicks pour gerer le temps 

Si SDL_Delay est assez facile a comprendre et a utiliser, ce n'est pas le cas de la fonction 
SDL_GetTicks. II est temps d'apprendre a bien s'en servir. . . Voici un exemple! Nous 
allons reprendre notre bon vieux programme avec la fenetre afHchant Zozor a l'ecran 
(fig- 25.1). 

Cette fois, au lieu de le diriger au clavier ou a la souris, nous allons faire en sorte qu'il 
bouge tout seul sur l'ecran ! Pour faire simple, on va le faire bouger horizontalement 
sur la fenetre. 

On reprend pour commencer exactement le meme code source que celui qu'on avait 
utilise dans le chapitre sur les evenements. Vous devriez pouvoir creer un programme 
aussi simple sans avoir besoin de mon aide, ici. Si neanmoins vous en avez besoin, vous 
pouvez recuperer le code source de base sur Internet. 

t> ( Code web : 534918 ) 

Interessons-nous a Zozor. Nous voulons le faire bouger. Pour cela, le mieux est d'utiliser 
SDL_GetTicks. On va avoir besoin de deux variables : tempsPrecedent et tempsActuel. 
Elles vont stocker le temps retourne par SDL_GetTicks a des moments differents. II nous 
sufHra de faire la difference entre tempsActuel et tempsPrecedent pour voir le temps 
qui s'est ecoule. Si le temps ecoule est par exemple superieur a 30 ms, alors on change 
les coordonnees de Zozor. 

Commencez done par creer ces deux variables dont on va avoir besoin : 

lint tempsPrecedent = 0, tempsActuel = 0; 
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Figure 25.1 - Zozor au centre de l'ecran 



Maintenant, dans notre boucle infinie, nous allons ajouter le code suivant : 



tempsActuel = SDL_GetTicks () ; 

if (tempsActuel - tempsPrecedent > 30) /* Si 30 ms se sont ecoulees */ 

{ 

positionZozor .x++; /* On bouge Zozor */ 

tempsPrecedent = tempsActuel; /* Le temps "actuel" devient le temps 
<— ¥ "precedent" pour nos futurs calculs */ 
} 



Comprenez bien ce qui se passe. 

1. On prend le temps actuel grace a SDL_GetTicks. 

2. On compare au temps precedemment enregistre. S'il y a un ecart de 30 ms au 
moins, alors. . . 

3. ... on bouge Zozor, car on veut qu'il se deplace toutes les 30 ms. Ici, on le decale 
juste vers la droite toutes les 30 ms 3 . 

4. Puis, et c'est vraiment ce qu'il ne faut pas oublier, on place le temps « actuel » 
dans le temps « precedent ». En effet, imaginez le prochain tour de boucle : le 



3. II faut verifier si le temps est superieur a 30 ms, et non egal a 30 ms ! En effet, il faut verifier si 
au moins 30 ms se sont ecoulees. Rien ne vous garantit que l'instruction sera executee pile poil toutes 
les 30 ms. 
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temps « actuel » aura change, et on pourra le comparer au temps precedent. A 
nouveau, on pourra verifier si 30 ms se seront ecoulees et bouger Zozor. 



Et que se passe-t-il si la boucle met moins de temps que 30 ms? 



Lisez mon code : il ne se passe rien ! On ne rentre pas dans le if, on ne fait done 
rien. On attend le prochain tour de boucle ou on verifiera a nouveau si 30 ms se seront 
ecoulees depuis la derniere fois qu'on a fait bouger Zozor. 

Ce code est court, mais il faut le comprendre ! Relisez mes explications autant de fois 
que necessaire, parce que e'etait probablement le passage le plus important du chapitre. 

Un changement dans la gestion des evenements 

Notre code est parfait a un detail pres : la fonction SDL_WaitEvent. Elle etait tres 
pratique jusqu'ici, puisqu'on n'avait pas a gerer le temps. Cette fonction mettait en 
pause le programme (un peu a la maniere de SDL_Delay) tant qu'il n'y avait pas 
d'evenement. 

Or ici, on n'a pas besoin d'attendre un evenement pour faire bouger Zozor ! II doit 
bouger tout seul. Vous n'allez quand meme pas bouger la souris juste pour generer des 
evenements et done faire sortir le programme de la fonction SDL_WaitEvent ! 

La solution ? SDL_PollEvent. Je vous avais deja presente cette fonction : contrairement 
a SDL_WaitEvent, elle renvoie une valeur, qu'il y ait eu un evenement ou non. On dit 
que la fonction n'est pas bloquante : elle ne met pas en pause le programme, la boucle 
infinie va done tourner tout le temps. 

Code complet 

Voici le code final que vous pouvez tester : 

int main(int argc, char *argv[]) 
{ 

SDL_Surface *ecran = HULL, *zozor = NULL; 

SDL_Rect positionZozor ; 

SDL_Event event ; 

int continuer = 1 ; 

int tempsPrecedent = 0, tempsActuel = 0; 

SDL_Init(SDL_INIT_VIDE0) ; 

ecran = SDL_SetVideoMode(640, 480, 32, SDL_HWSURFACE I SDL_D0UBLEBUF) ; 
SDL_WM_SetCaption("Gestion du temps en SDL", NULL); 



zozor = SDL_LoadBMP ("zozor .bmp") ; 
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SDL_SetColorKey(zozor, SDL_SRCCOLORKEY, SDL_MapRGB(zozor->f ormat , 0, 0, 
<-* 255)); 

positionZozor .x = ecran->w II- zozor->w / 2; 
positionZozor .y = ecran->h / 2 - zozor->h / 2; 

SDL_EnableKeyRepeat(10, 10); 

while (continuer) 
{ 

SDL_PollEvent (&event) ; /* On utilise PollEvent et non WaitEvent pour ne 
=->• pas bloquer le programme */ 
switch(event .type) 
{ 

case SDL_QUIT: 

continuer = 0; 
break; 
} 

tempsActuel = SDL_Get Ticks () ; 

if (tempsActuel - tempsPrecedent > 30) /* Si 30 ms se sont ecoulees 
°-> depuis le dernier tour de boucle */ 

{ 

positionZozor .x++; /* On bouge Zozor */ 

tempsPrecedent = tempsActuel; /* Le temps "actuel" devient le temps 
°-> "precedent" pour nos futurs calculs */ 

} 

SDL_FillRect(ecran, NULL, SDL_MapRGB(ecran->f ormat , 255, 255, 255)); 
SDL_BlitSurface (zozor , NULL, ecran, ftpositionZozor) ; 
SDL_Flip(ecran) ; 



SDL_FreeSurf ace (zozor) ; 
SDL_0uit() ; 

return EXIT_SUCCESS; 



> ( Code web : 887642 ) 



Vous devriez voir Zozor bouger tout seul sur l'ecran. II se decale vers la droite. Essayez 
par exemple de changer le temps de 30 ms en 15 ms : Zozor devrait se deplacer deux 
fois plus vite ! En effet, il se deplacera une fois toutes les 15 ms au lieu d'une fois toutes 
les 30 ms auparavant. 
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Consommer moins de CPU 

Actuellement, notre programme tourne en boucle indefiniment a la vitesse de la lumiere 
(enfin, presque). II consomme done 100 % du CPU. Pour voir cela, il vous suffit par 
exemple de faire CTRL + ALT + SUPPR (onglet Processus) sous Windows (fig. 



25.2). 

rlh-H .v. QD ■; 1 ?n y n 

[testsdl.exe 100 6 444 Ko 

' C am e i'aA jj i j fcanfc .ewe m 7 021 K a ' 

LVCOMSX.EXE 0\ 5 420 Ko 

wmplayer.exe 1ftn o, H rpil' 756 Ko 

HydraDM.exe "" , 032 Ko 

Figure 25.2 - Consommation du CPU par le programme 

Comme vous pouvez le voir, notre CPU est utilise a 100 % par notre programme 
testsdl.exe. Je vous l'ai dit plus tot : si vous codez un jeu (surtout un jeu plein 
ecran), ce n'est pas grave si vous utilisez 100 % du CPU. Mais si e'est un jeu dans 
une fenetre par exemple, il vaut mieux qu'il utilise le moins de CPU possible pour que 
l'utilisateur puisse faire autre chose sans que son PC ne « rame ». 

La solution ? On va reprendre exactement le meme code que ci-dessus, mais on va lui 
ajouter en plus un SDL_Delay pour patienter le temps qu'il faut afin que <ja fasse 30 
ms. 

On va juste ajouter un SDL_Delay dans un else : 

tempsActuel = SDL_GetTicks () ; 

if (tempsActuel - tempsPrecedent > 30) 

{ 

positionZozor . x++ ; 

tempsPrecedent = tempsActuel; 
} 

else /* Si 9a fait moins de 30 ms depuis le dernier tour de boucle, on endort le 
'—} programme le temps qu'il faut */ 
{ 

SDL_Delay(30 - (tempsActuel - tempsPrecedent)); 
} 

Comment cela fonctionne-t-il, cette fois? C'est simple, il y a deux possibilites (d'apres 
le if) : 

- soit <ja fait plus de 30 ms qu'on n'a pas bouge Zozor, dans ce cas on le bouge ; 

- soit ga fait moins de 30 ms, dans ce cas on fait dormir le programme avec SDL_Delay 
le temps qu'il faut pour atteindre les 30 ms environ. D'ou mon petit calcul 30 - 
(tempsActuel - tempsPrecedent) . Si la difference entre le temps actuel et le temps 
precedent est par exemple de 20 ms, alors on endormira le programme (30 - 20) = 
10 ms afin d'atteindre les 30 ms. 

Rappelez-vous que SDL_Delay mettra peut-etre quelques millisecondes de 
plus que prevu. . . 




a 
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Avec ce code, notre programme va « dormir » la plupart du temps et done consommer 
tres peu de CPU (fig. 25.3). 



[ testsdl.exe 00 6 444 Ko 

* C am e i'aA jj i j fcanfc .ewe m 7 021 K a ' 

LVCOMSX.EXE 0\ 5 420 Ko 

wmplayer.exe ^i,.- ,| M rpii'756Ko 

HydraDM.exe " „„ , 032 Ko 

Figure 25.3 - Consommation de CPU reduite 

En moyenne, le programme utilise maintenant entre et 1 % de CPU. . . Parfois il 
utilise legerement plus, mais il retombe rapidement a % de CPU. 

Controler le nombre d'images par seconde 

Vous vous demandez certainement comment on peut limiter (fixer) le nombre d'images 
par seconde 4 affichees par l'ordinateur. 

Eh bien e'est exactement ce qu'on est en train de faire ! Ici, on affiche une nouvelle image 
toutes les 30 ms en moyenne. Sachant qu'une seconde vaut 1000 ms, pour trouver le 
nombre de FPS (images par seconde), il suffit de faire une division : 1000 / 30 = 33 
images par seconde environ. 

Pour l'ceil humain, une animation est fluide si elle contient au moins 25 images / se- 
conde. Avec 33 images / seconde, notre animation sera done tout a fait fluide, elle 
n'apparaitra pas « saccadee ». 

Si vous voulez plus d'images par seconde, il faut reduire la limite de temps entre deux 
images. Passez de 30 a 20 ms, et <ja vous fera du 1000 / 20 = 50 FPS. 

Exercices 

La manipulation du temps n'est pas evidente, il serait bien de vous entrainer un peu, 
qu'en dites-vous ? Voici quelques exercices. 

- Pour le moment, Zozor se decale vers la droite puis disparait de l'ecran. Ce serait 
mieux s'il repartait dans l'autre sens une fois arrive tout a droite, non ? Cela donnerait 
l'impression qu'il rebondit. Je vous conseille de creer un booleen versLaDroite qui 
vaut « vrai » si Zozor se deplace vers la droite (et « faux » s'il va vers la gauche). 
Si le booleen vaut vrai, vous decalez done Zozor vers la droite, sinon vous le decalez 
vers la gauche. Surtout, n'oubliez pas de changer la valeur du booleen lorsque Zozor 
atteint le bord droit ou le bord gauche. Eh oui, il faut bien qu'il reparte dans l'autre 
sens ! 

- Plutfit que de faire rebondir Zozor de droite a gauche, faites le rebondir en diago- 
nale sur l'ecran! II vous suffira de modifier positionZozor.x et positionZozor.y 



4. Couramment abrege FPS pour « Frames per second ». 
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simultanement. Vous pouvez essayer de voir ce que ca fait si on augmente x et si on 
diminue y en meme temps, ou bien si on augmente les deux en meme temps, etc. 
Faites en sorte qu'un appui sur la touche P empeche Zozor de se deplacer, et qu'un 
nouvel appui sur la touche P relance le deplacement de Zozor. C'est un bete booleen 
a activer et desactiver. 



Les timers 



A 



L'utilisation des timers est un peu complexe. Elle fait intervenir une notion 
qu'on n'a pas vue jusqu'ici : les pointeurs de fonctions. II n'est pas indispen- 
sable d'utiliser les timers : si vous les trouvez trop delicats a utiliser, vous 
pouvez passer votre chemin sans probleme. 



Les timers constituent une autre fagon de realiser ce qu'on vient de faire avec la fonc- 
tion SDL_GetTicks. C'est une technique un peu particuliere. Certains la trouveront 
pratique, d'autres non. Cela depend done des gouts du programmeur. 

Qu'est-ce qu'un timer? C'est un systeme qui permet de demander a la SDL d'ap- 
peler une fonction toutes les X millisecondes. Vous pourriez ainsi creer une fonction 
bougerEnnemi () que la SDL appellerait automatiquement toutes les 50 ms afin que 
l'ennemi se deplace a intervalles reguliers. 

Comme je viens de vous le dire, cela est aussi faisable avec SDL_GetTicks en 
utilisant la technique qu'on a vue plus haut. Quel avantage, alors? Eh bien 
disons que les timers nous obligent a mieux structurer notre programme en 
fonctions. 




a 



Initialiser le systeme de timers 

Pour pouvoir utiliser les timers, vous devez d'abord initialiser la SDL avec un flag 
special : SDL_INIT_TIMER. Vous devriez done appeler votre fonction SDL_Init comme 
ceci : 

| SDL_Init(SDL_INIT_VIDEu | SDL_INIT_TIMER) ; 
La SDL est maintenant prete a utiliser les timers ! 

Ajouter un timer 

Pour ajouter un timer, on fait appel a la fonction SDL_AddTimer 5 dont void le proto- 
type : 



5. II existe en fait deux fonctions permettant d'ajouter un timer en SDL : SDL_AddTimer et 
SDL_SetTimer. Elles sont quasiment identiques. Cependant, SDL_SetTimer est une fonction ancienne 
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SDL_TimerID SDL_AddTimer (Uint32 interval, SDL_NewTimerCallback callback, 
«-> void *param) ; 

On envoie trois parametres a la fonction : 

- l'intervalle de temps (en ms) entre chaque appel de la fonction ; 

- le nom de la fonction a appeler. On appelle cela un callback : le programme se 
charge de rappeler cette fonction de callback regulierement ; 

- les parametres a envoyer a votre fonction de callback. 

Comment? Un nom de fonction peut servir de parametre? Je croyais qu'on 
V ne pouvait envoyer que des variables ! 

En fait, les fonctions sont aussi stockees en memoire au chargement du programme. 
Elles ont done elles aussi une adresse. Du coup, on peut creer des. . . pointeurs de 
fonctions 6 ! II suffit d'ecrire le nom de la fonction a appeler pour indiquer l'adresse 
de la fonction. Ainsi, la SDL saura a quelle adresse en memoire elle doit se rendre pour 
appeler votre fonction de callback. 

SDL_AddTimer renvoie un numero de timer (un « ID »). Vous devez stocker ce resultat 
dans une variable de type SDL_TimerID. Cela vous permettra par la suite de desactiver 
le timer : il vous suffira d'indiquer l'ID du timer a arreter. 

La SDL vous permet d'activer plusieurs timers en meme temps. Cela explique l'interet 
de stocker un ID de timer pour pouvoir les differencier. 

On va done creer un ID de timer : 

I SDL_TimerID timer; /* Variable pour stocker le numero du timer */ 

. . . puis on va creer notre timer : 

I timer = SDL_AddTimer(30, bougerZozor, fepositionZozor) ; /* Demarrage du timer */ 

Ici, je cree un timer qui a les proprietes suivantes : 

- il sera appele toutes les 30 ms ; 

- il appellera la fonction de callback bougerZozor ; 

- il lui enverra comme parametre un pointeur sur la position de Zozor pour qu'il puisse 
la modifier. 

Vous l'aurez compris : le role de la fonction bougerZozor sera de changer la position 
de Zozor toutes les 30 ms. 



qui existe toujours pour des raisons de compatibilite. Aujourd'hui, si on veut bien faire les choses, on 
nous recommande done d'utiliser SDL_AddTimer. 

6. Si vous souhaitez en savoir plus sur les pointeurs de fonctions, je vous invite a lire le tutoriel 
redige par mleg sur le Site du Zero qui traite de ce sujet (code web : 199183). 
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Creation de la fonction de callback 

Attention : il faut etre particulierement vigilant ici. Votre fonction de callback doit 
obligatoirement avoir le prototype suivant : 

I Uint32 nomDeLaFonction(Uint32 intervalle, void *parametre) ; 

Pour creer le callback bougerZozor, je devrai done ecrire la fonction comme ceci : 

I Uint32 bougerZozor (Uint32 intervalle, void *parametre) ; 

Voici maintenant le contenu de ma fonction bougerZozor, qui est plus delicate qu'il 
n'y parait : 

/* Fonction de callback (sera appelee toutes les 30 ms) */ 
Uint32 bougerZozor (Uint32 intervalle, void *parametre) 
{ 

SDL_Rect* positionZozor = parametre; /* Conversion de void* en SDL_Rect* */ 

posit ionZozor->x++; 

return intervalle ; 
} 

La fonction bougerZozor sera done automatiquement appelee toutes les 30 ms par la 
SDL. La SDL lui enverra toujours deux parametres (ni plus, ni moins) : 

- l'intervalle de temps qui separe deux appels de la fonction (ici, ga sera 30 ms) ; 

- le parametre « personnalise » 7 que vous avez demande a envoyer a la fonction. 
Remarquez, et e'est tres important, que ce parametre est un pointeur sur void. Cela 
signifie que e'est un pointeur qui peut pointer sur n'importe quoi : un int, une 
structure personnalisee, ou comme ici un SDL_Rect (positionZozor). 

Le probleme, e'est que ce parametre est un pointeur de type inconnu (void) pour la 
fonction. II va done falloir dire a l'ordinateur que ce parametre est un SDL_Rect* (un 
pointeur sur SDL_Rect). 

Pour faire ga, je cree un pointeur sur SDL_Rect dans ma fonction qui prend comme 
valeur. . . le pointeur parametre. 

) Quel interet d'avoir cree un DEUXIEME pointeur qui contient la meme 

adresse? 



L'interet, e'est que positionZozor est de type SDL_Rect* contrairement a la variable 
parametre qui etait de type void*. 




7. II n'est pas possible d'envoyer plus d'un parametre personnalise a la fonction de callback. Heu- 
reusement, vous pouvez toujours creer un type personnalise (ou un tableau) qui sera un assemblage 
des variables que vous voulez transmettre. 
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Vous pourrez done acceder a positionZozor->x et positionZozor->y. Si vous aviez 
fait parametre->x ou parametre->y, le compilateur aurait tout rejete en bloc parce 
que le type void ne contient pas de sous-variable x et y. 

Apres, la ligne suivante est simple : on modifie la valeur de positionZozor->x pour 
decaler Zozor vers la droite. 

Derniere chose, tres importante : vous devez retourner la variable intervalle. Cela 
indiquera a la SDL qu'on veut continuer a faire en sorte que la fonction soit appelee 
toutes les 30 ms. Si vous voulez changer l'intervalle d'appel, il suffit de renvoyer une 
autre valeur (mais bien souvent, on ne change pas cet intervalle). 

Arreter le timer 

Pour arrgter le timer, e'est tres simple : 

I SDL_RemoveTimer(timer) ; /* Arret du timer */ 

II suffit d'appeler SDL_RemoveTimer en indiquant FID du timer a arreter. Ici, j'arrete 
le timer juste apres la boucle infinie, au meme endroit que les SDL_FreeSurf ace. 



En resume 

- La fonction SDL_Delay permet de mettre en pause le programme un certain nombre 
de millisecondes. Cela permet de reduire Futilisation du CPU qui n'est alors plus 
monopolise par votre programme. 

- On peut connaitre le nombre de millisecondes ecoulees depuis le lancement du pro- 
gramme avec SDL_GetTicks. Avec quelques petits calculs, on peut s'en servir pour 
effectuer une gestion des evenements non bloquante avec SDL_PollEvent. 

- Les timers constituent un systeme qui permet de rappeler une de vos fonctions 
(dite de callback) a intervalles reguliers. Le meme resultat peut etre obtenu avec 
SDL_GetTicks mais les timers aident a rendre le programme plus lisible et mieux 
structure. 



423 



CHAPITRE 25. MAITRISEZ LE TEMPS ! 



424 



Chapitre 



26 



Ecrire du texte avec SDL ttf 



Je suis persuade que la plupart d'entre vous se sont deja pose cette question : « Mais 
bon sang, il n'y a done aucune fonction pour ecrire du texte dans une fenetre SDL? ». 
II est temps de vous apporter la reponse : e'est non. 

Cependant, il y a quand meme moyen d'y arriver. II suffit d'utiliser. . . la ruse ! On peut par 
exemple blitter des images de lettres une a une a I'ecran. Ca fonctionne, mais ce n'est pas 
ce qu'il y a de plus pratique. 

Heureusement, il y a plus simple : on peut utiliser la bibliotheque SDL_ttf. C'est une 
bibliotheque qui vient s'ajouter par-dessus la SDL, tout comme SDL_image. Son role est 
de creer une SDL_Surf ace a partir du texte que vous lui envoyez. 













£ S!! -£ 


d/ 
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Installer SDL_ttf 

II faut savoir que, comme SDL_image, SDL_ttf est une bibliotheque qui necessite que 
la SDL soit installee 1 . 

Tout comme SDL_image, SDL_ttf est une des bibliotheques liees a la SDL les plus popu- 
lates (c'est-a-dire qu'elle est tres telechargee) . Comme vous allez pouvoir le constater, 
cette bibliotheque est effect ivement bien faite. Une fois que vous aurez appris a l'utiliser, 
vous ne pourrez plus vous en passer ! 

Comment fonctionne SDL_ttf ? 

SDL_ttf n'utilise pas des images bitmap pour generer du texte dans des surfaces. C'est 
une methode en effet assez lourde a mettre en place et on n'aurait pu utiliser qu'une 
seule police. En fait, SDL_ttf fait appel a une autre bibliotheque : FreeType. C'est une 
bibliotheque capable de lire les fichiers de police (.ttf) et d'en sortir l'image. SDL_ttf 
recupere done cette image et la convertit pour la SDL en creant une SDL_Surf ace. 

SDL_ttf a done besoin de la bibliotheque FreeType pour fonctionner, sinon elle ne sera 
pas capable de lire les fichiers .ttf. 

Si vous etes sous Windows et que vous prenez, comme je le fais, la version compilee 
de la bibliotheque, vous n'aurez pas besoin de telecharger quoi que ce soit de plus car 
FreeType sera incluse dans la DLL SDL_ttf .dll. Vous n'avez done rien a faire. 

Si vous etes sous Linux ou Mac OS et que vous devez recompiler la bibliotheque, il 
vous faudra en revanche FreeType pour compiler. Rendez-vous sur la page de telechar- 
gement de FreeType pour recuperer les fichiers pour developpeurs. 



> ( Code web : 205881 ) 

Installer SDL.ttf 

Rendez-vous sur la page de telechargement de SDL_ttf . 

t> ( Code web : 187727 ) 

La, choisissez le fichier qu'il vous faut dans la section Binary 2 . 

Le fichier ZIP contient comme d'habitude un dossier include et un dossier lib. Placez 
le contenu du dossier include dans mingw32/include/SDL et le contenu du dossier 
lib dans mingw32/lib. 



1. Bon : si a ce stade du cours vous n'avez toujours pas installe la SDL, c'est grave, done je vais 
supposer que c'est deja fait ! 

2. Sous Windows, vous remarquerez qu'il n'y a que deux fichiers .zip ayant le suffixe Win32 et VC6. 
Le premier (win32) contient la DLL que vous aurez besoin de livrer avec votre executable. Vous aurez 
aussi besoin de mettre cette DLL dans le dossier de votre projet pour pouvoir tester votre programme, 
evidemment. 

Le second (VC6) contient les .h et .lib dont vous allez avoir besoin pour programmer. On pourrait 
penser d'apres le nom que ga n'est fait que pour Visual C++, mais en fait, exceptionnellement, le fichier 
.lib livre ici marche aussi avec mingw32, il fonctionnera done sous Code: :Blocks. 
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Vous devez copier le fichier SDL_ttf.h dans le dossier 
mingw32/include/SDL et non pas dans mingw3 2 /include tout court. 
Attention aux erreurs ! 



Configurer un projet pour SDL_ttf 

II nous reste une derniere petite chose a faire : configurer notre projet pour qu'il utilise 
bien SDL_ttf . II va falloir modifier les options du linker pour qu'il compile bien votre 
programme en utilisant la bibliotheque SDL_ttf . 

Vous avez deja appris a faire cette operation pour la SDL et pour SDL_image, je vais 
done aller plus vite. Comme je travaille sous Code: :Blocks, je vais vous donner la 
procedure avec cet IDE. Ce n'est pas bien different avec les autres IDE : 

- rendez-vous dans le menu Project / Build Options; 

- dans l'onglet Linker, cliquez sur le petit bouton Add ; 

- indiquez ou se trouve le fichier SDL_ttf .lib 3 ; 

- on vous demande Keep this as a relative path ? Peu importe ce que vous repondez, 
ga marchera dans les deux cas. Je vous conseille quand meme de repondre par la 
negative, car sinon votre projet ne fonctionnera plus si vous le deplacez dans un 
autre dossier ; 

- validez en cliquant sur OK. 



On n'a pas besoin de linker avec la bibliotheque FreeType aussi ? 



Non, car comme je vous l'ai dit FreeType est incluse dans la DLL de SDL_ttf . Vous 
n'avez pas a vous preoccuper de FreeType, e'est SDL_ttf qui gere ga, maintenant. 

La documentation 

Maintenant que vous commencez a devenir des programmeurs aguerris, vous devriez 
vous demander immediatement : « Mais ou est la doc' ? » 4 . 

II y a certes des cours qui detaillent le fonctionnement des bibliotheques, comme ce 
livre. Toutefois. . . 

- Je ne vais pas faire un chapitre pour toutes les bibliotheques qui existent (meme en 
y passant ma vie, je n'aurais pas le temps). II va done falloir tot ou tard lire une 
doc', et mieux vaut commencer a apprendre a le faire maintenant ! 

- D'autre part, une bibliotheque est en general assez complexe et contient beaucoup 
de fonctions. Je ne peux pas presenter toutes ces fonctions dans un chapitre, ce serait 
bien trop long ! 




3. Chez moi, e'est dans C:\Program Files\CodeBlocks\mingw32\lib. 

4. Si vous ne vous etes pas encore pose cette question, e'est que vous n'etes pas encore des pro- 
grammeurs aguerris. ;-) 
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En clair : les documentations ont l'avantage d'etre completes et on ne peut parfois pas 
y couper. Je vous conseille done de mettre des a present dans vos favoris l'adresse de 
la doc' de SDL ttf. 



> [ Code web : 274050 ) 

La doc' est disponible en plusieurs formats : HTML en ligne, HTML zippe, PDF, etc. 
Prenez la version qui vous arrange le plus. 

Vous verrez que SDL_ttf est une bibliotheque tres simple : il y a peu de fonctions 
(environ 40-50) 5 . Cela devrait etre signe (pour les programmeurs aguerris que vous 
etes ;-) ) que cette bibliotheque est simple et que vous saurez la manier assez vite. 

Allez, il est temps d'apprendre a utiliser SDL_ttf , maintenant ! 

Chargement de SDL_ttf 

L'include 

Avant toute chose, il faut ajouter l'include suivant en haut de votre fichier .c : 

| #include <SDL/SDL_ttf .h> 

Si vous avez des erreurs de compilation a ce stade, verifiez si vous avez bien place le 
fichier SDL_ttf .h dans le dossier mingw32/include/SDL et non dans mingw32/include 
tout court. 



Demarrage de SDL_ttf 

Tout comme la SDL, SDL_ttf a besoin d'etre demarree et arretee. II y a done des 
fonctions tres similaires a celles de la SDL : 

- TTF_Init : demarre SDL_ttf ; 

- TTF_Quit : arrete SDL_ttf . 



n'est pas necessaire que la SDL soit demarree avant SDL_ttf . 




a 



Pour demarrer SDL_ttf (on dit aussi « initialiser »), on doit done appeler la fonction 
TTF_Init(). Aucun parametre n'est necessaire. La fonction renvoie -1 s'il y a eu une 
erreur. 

Vous pouvez done demarrer SDL_ttf tres simplement comme ceci : 

|TTF_Init() ; 
5. Oui, e'est peu ! 
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Si vous voulez verifier s'il y a une erreur et etre ainsi plus rigoureux, utilisez plutot ce 
code : 

if (TTF_Init() == -1) 
{ 

fprintf (stderr, "Erreur d'initialisation de TTF_Init : */,s\n", 
<-> TTF_GetError()) ; 

exit (EXIT_FAILURE) ; 
} 

S'il yaeu une erreur au demarrage de SDL_ttf, un fichier stderr.txt sera cree (sous 
Windows, du moins) contenant un message explicatif de l'erreur. Pour ceux qui se 
poseraient la question : la fonction TTF_GetError () renvoie le dernier message d'erreur 
de SDL_ttf . C'est pour cela qu'on l'utilise dans le fprintf. 



Arret de SDL.ttf 

Pour arreter SDL_ttf, on appelle TTF_Quit () . La encore, pas de parametre, pas de 
prise de tete. Vous pouvez appeler TTF_Quit avant ou apres SDL_Quit, peu importe. 



|TTF_Quit(); 



Chargement d'une police 

Bon tout <ja c'est bien beau mais ce n'est pas assez complique, on ne s'amuse pas. 
Passons aux choses serieuses, si vous le voulez bien : maintenant que SDL_ttf est 
chargee, nous devons charger une police. Une fois que cela sera fait, nous pourrons 
enfin voir comment ecrire du texte ! 

La encore il y a deux fonctions : 

- TTF_OpenFont : ouvre un fichier de police (.ttf) ; 
TTF_CloseFont : ferme une police ouverte. 

TTF_OpenFont doit stocker son resultat dans une variable de type TTF_Font. Vous 
devez creer un pointeur de TTF_Font, comme ceci : 

| TTF_Font *police = NULL; 

Le pointeur police contiendra done les informations sur la police une fois qu'on l'aura 
ouverte. 

La fonction TTF_OpenFont prend deux parametres : 

- le nom du fichier de police (au format . ttf) a ouvrir. L'ideal c'est de mettre le fichier 
de police dans le repertoire de votre projet. Exemple de fichier : arial.ttf (pour la 
police Arial) ; 
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- la taille de la police a utiliser. Vous pouvez par exemple utiliser une taille de 22. Ce 
sont les memes tailles que celles que vous utilisez dans un logiciel de traitement de 
texte tel que Word. 

II nous reste a trouver ces fameuses polices . ttf . Vous en avez deja un certain nombre 
sur votre ordinateur, mais vous pouvez en telecharger sur Internet comme on va le voir. 

Sur votre ordinateur 

Vous en avez deja sur votre ordinateur ! Si vous etes sous Windows, vous en trouverez 
beaucoup dans le dossier C:\Windows\Fonts. Vous n'avez qu'a copier le fichier de police 
qui vous plait dans le dossier de votre projet. 

Si le nom contient des caracteres « bizarres » comme des espaces, des accents ou 
meme des majuscules, je vous conseille de le renommer. Pour etre sur de n'avoir aucun 
probleme, n'utilisez que des minuscules et evitez les espaces. 

- Exemple de nom incorrect : TIMES NEW ROMAN . TTF ; 

- Exemple de nom correct : times. ttf. 

Sur Internet 

Autre possibility : recuperer une police sur Internet. Vous trouverez plusieurs sites 
proposant des polices gratuites et originales a telecharger. 

Je vous recommande personnellement dafont.com, qui est bien classe, tres bien fourni 
et varie. 

t> ( Code web : 771162) 

Les fig. 26.1, 26.2 et 26.3 vous donnent un apergu de polices que vous pourrez y trouver 
tres facilement. 






H ID 

Figure 26.1 - Police Alpha Wood 

RAVEN 

Figure 26.2 - Police Raven 



Charger la police 

Je vous propose d'utiliser la police Angelina pour la suite des exemples. Vous pouvez 
la telecharger en ligne. 
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Figure 26.3 - Police Angelina 




> ( Code web : 312524 ) 

On ouvrira la police comme ceci : 

I police = TTF_OpenFont ("angelina. ttf " , 65); 

La police utilisee sera angelina. ttf . J'ai bien pris soin de mettre le fichier dans le 
dossier de mon projet et de le renommer pour qu'il soit tout en minuscules. La police 
sera de taille 65. Qa parait gros mais visiblement, c'est une police qu'il faut ecrire en 
gros pour qu'on puisse la voir. 

Ce qui est tres important, c'est que TTF_OpenFont stocke le resultat dans la variable 
police. Vous allez reutiliser cette variable tout a l'heure en ecrivant du texte. Elle 
permettra d'indiquer la police que vous voulez utiliser pour ecrire votre texte. 

Vous n'avez pas besoin d'ouvrir la police a chaque fois que vous ecrivez du 
texte : ouvrez-la une fois au debut du programme et fermez-la a la fin. 



Fermer la police 

II faut penser a fermer chaque police ouverte avant l'appel a TTF_Quit(). Dans mon 
cas, ga donnera done le code suivant : 

TTF_CloseFont (police) ; /* Doit etre avant TTF_Quit() */ 
TTF_Quit(); 

Et voila le travail ! 



Les differentes methodes d'ecriture 

Maintenant que SDL_ttf est chargee et qu'on a une variable police chargee elle aussi, 
plus rien ni personne ne nous empechera d'ecrire du texte dans notre fenetre SDL ! 

Bien : ecrire du texte c'est bien, mais avec quelle fonction? D'apres la doc', pas moins 
de 12 fonctions sont disponibles ! 

En fait, il y a trois fagons differentes pour SDL_ttf de dessiner du texte. 
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- Solid (fig. 26.4) : c'est la technique la plus rapide. Le texte sera rapidement ecrit 
dans une SDL_Surf ace. La surface sera transparente mais n'utilisera qu'un niveau de 
transparence (on a appris <ja il y a quelques chapitres). C'est pratique, mais le texte 
ne sera pas tres joli, pas tres « arrondi », surtout s'il est ecrit gros. Utilisez cette 
technique lorsque vous devez souvent changer le texte, par exemple pour afficher le 
temps qui s'ecoule ou le nombre de FPS d'un jeu. 

- Shaded (fig. 26.5) : cette fois, le texte sera joli. Les lettres seront antialiasees 6 , le 
texte apparaitra plus lisse. II y a un defaut, en revanche : le fond doit etre d'une 
couleur unie. II est impossible de rendre le fond de la SDL_Surf ace transparente en 
Shaded. 

- Blended (fig. 26.6) : c'est la technique la plus puissante, mais elle est lente. En fait, 
elle met autant de temps que Shaded a creer la SDL_Surf ace. La seule difference avec 
Shaded, c'est que vous pouvez blitter le texte sur une image et la transparence sera 
respectee (contrairement a Shaded qui imposait un fond uni). Attention : le calcul 
du blit sera plus lent que pour Shaded. 




Figure 26.4 - Solid : mode d'ecriture tres rapide mais peu esthetique (texte non lisse) 




Figure 26.5 - Shaded : mode d'ecriture lent mais plus joli car antialise — fond obli- 
gatoirement uni 



En resume : 



6. Cela signifie que leurs contours seront adoucis, ce qui est plus agreable a l'oeil. 
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Figure 26.6 - Blended : mode d'ecriture lent (et blit lent) mais bien plus beau car 
antialise et fonctionne sur un fond non uni 



- si vous avez un texte qui change souvent, comme un compte a rebours, utilisez Solid ; 

- si votre texte ne change pas tres souvent et que vous voulez blitter votre texte sur 
un fond uni, utilisez Shaded ; 

- si votre texte ne change pas tres souvent mais que vous voulez blitter sur un fond 
non uni (comme une image), utilisez Blended. 

Voila, vous devriez deja etre un peu plus familiers avec ces trois types d'ecriture de 
SDL_ttf. 

Je vous avais dit qu'il y avait 12 fonctions en tout. En effet, pour chacun de ces trois 
types d'ecriture, il y a quatre fonctions. Chaque fonction ecrit le texte a l'aide d'un 
charset different, c'est-a-dire d'une palette de caracteres differente. Ces quatre fonctions 
sont : 

- Latinl ; 

- UTF8; 

- Unicode ; 

- Unicode Glyph. 

L'ideal est d'utiliser l'Unicode car c'est un charset gerant la quasi-totalite des caracteres 
existant sur Terre. Toutefois, utiliser l'Unicode n'est pas toujours forcement simple (un 
caractere prend plus que la taille d'un char en memoire), nous ne verrons done pas 
comment l'utiliser ici. 

A priori, si votre programme est ecrit en frangais le mode Latinl suffit amplement, 
vous pouvez vous contenter de celui-la. 

Les trois fonctions utilisant le charset Latinl sont : 

- TTF_RenderText_Solid; 

- TTF_RenderText_Shaded ; 

- TTF_RenderText_Blended. 
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Exemple d'ecriture de texte en Blended 

Pour specifier une couleur a SDL_ttf , on ne va pas utiliser le meme type qu'avec la 
SDL (un Uint32 cree a l'aide de la fonction SDL_MapRGB). Au contraire, nous allons 
utiliser une structure toute prete de la SDL : SDL_Color. Cette structure comporte 
trois sous- variables : la quantite de rouge, de vert et de bleu. 

Si vous voulez creer une variable couleurNoire, vous devrez done ecrire : 
| SDL_Color couleurNoire = {0, 0, 0}; 



A 



Attention a ne pas confondre avec les couleurs qu'utilise habituellement la 
SDL! La SDL utilise des Uint32 crees a l'aide de SDL_MapRGB. SDL_ttf 
utilise des SDL_Color. 



On va ecrire un texte en noir dans une SDL_Surface texte : 

I texte = TTF_RenderText_Blended(police, "Salut les ZerOs !", couleurNoire); 

Vous voyez dans l'ordre les parametres a envoyer : la police (de type TTF_Font), lc 
texte a ecrire, et enfin la couleur (de type SDL_Color). Le resultat est stocke dans 
une SDL_Surf ace. SDL_ttf calcule automatiquement la taille necessaire a donner a la 
surface en fonction de la taille du texte et du nombre de caracteres que vous avez voulu 
ecrire. 

Comme toute SDL_Surf ace, notre pointeur texte contient les sous- variables w et h indi- 
quant respectivement sa largeur et sa hauteur. C'est done un bon moyen de connaitre 
les dimensions du texte une fois que celui-ci a ete ecrit dans la SDL_Surf ace. Vous 
n'aurez qu'a ecrire : 

texte->w /* Donne la largeur */ 
texte->h /* Donne la hauteur */ 



Code complet d'ecriture de texte 

Vous savez desormais tout ce qu'il faut connaitre sur SDL_ttf . Voyons pour resumer 
un code complet d'ecriture de texte en mode Blended : 

#include <stdlib.h> 

#include <stdio.h> 

#include <SDL/SDL.h> 

#include <SDL/SDL_image .h> 

#include <SDL/SDL_ttf .h> 

int main(int argc, char *argv[]) 
{ 
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SDL_Surface *ecran = NULL, *texte = NULL, *fond = NULL; 

SDL_Rect position; 

SDL_Event event ; 

TTF_Font *police = NULL; 

SDL_Color couleurNoire = {0, 0, 0}; 

int continuer = 1; 

SDL_Init(SDL_INIT_VIDEO) ; 
TTF_Init() ; 

ecran = SDL_SetVideoMode(640, 480, 32, SDL_HWSURFACE I SDL_D0UBLEBUF) ; 
SDL_WM_SetCaption("Gestion du texte avec SDL_ttf", NULL); 

fond = IMG_LoadCmoraira.jpg"); 

/* Chargement de la police */ 

police = TTF_0penFont ("angelina.ttf " , 65); 

/* Ecriture du texte dans la SDL_Surface texte en mode Blended (optimal) */ 

texte = TTF_RenderText_Blended(police, "Salut les ZerOs !", couleurNoire); 

while (continuer) 
{ 

SDL_WaitEvent (ftevent) ; 
switch(event .type) 
{ 

case SDL_QUIT: 

continuer = 0; 
break; 
} 

SDL_FillRect (ecran, NULL, SDL_MapRGB(ecran->f ormat , 255, 255, 255)); 

position. x = 0; 
position. y = 0; 
SDL_BlitSurface(f ond, NULL, ecran, &position) ; /* Blit du fond */ 

position. x = 60; 
position. y = 370; 

SDL_BlitSurf ace (texte, NULL, ecran, ftposition) ; /* Blit du texte */ 
SDL_Flip (ecran) ; 
} 

TTF_CloseFont (police) ; 
TTF_Quit() ; 

SDL_FreeSurf ace (texte) ; 
SDL_Quit() ; 

return EXIT_SUCCESS; 
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> Code web : 285494 



Le resultat vous est presente sur la fig. 26.7. 




Gdott hss ZerOs f 



Figure 26.7 - Un texte ecrit a l'aide de SDL_ttf 



Si vous voulez changer de mode d'ecriture pour tester, il n'y a qu'une ligne a modifier 
celle creant la surface (avec l'appel a la fonction TTF_RenderText_Blended). 



A 



La fonction TTF_RenderText_Sh.aded prend un quatrieme parametre, 
contrairement aux deux autres. Ce dernier parametre est la couleur de fond a 
utiliser. Vous devrez done creer une autre variable de type SDL_Color pour 
indiquer une couleur de fond (par exemple le blanc). 



Attributs d'ecriture du texte 

II est aussi possible de specifier des attributs d'ecriture, comme gras, italique et souligne. 

II faut d'abord que la police soit chargee. Vous devriez done avoir une variable police 
valide. Vous pouvez alors faire appel a la fonction TTF_SetFontStyle qui va modifier 
la police pour qu'elle soit en gras, italique ou souligne selon vos desirs. 

La fonction prend deux parametres : 

- la police a modifier ; 

- une combinaison de flags pour indiquer le style a donner : gras, italique ou souligne. 

Pour les flags, vous devez utiliser ces constantes : 
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ttf _ STY le_NORMAL : normal ; 
ttf _ STY le_B0LD : gras ; 
ttf _ STY le_ITALIC : italique ; 
ttf _ STY le_UNDERLINE : souligne. 

Comme c'est vine liste de flags, vous pouvez les combiner a l'aide du symbole I comme 
on a appris a le faire. 

Testons : 

/* Chargement de la police */ 

police = TTF_OpenFont ("angelina. ttf " , 65); 

/* Le texte sera ecrit en italique et souligne */ 

TTF_SetFontStyle (police, TTF_STYLE_ITALIC I TTF_STYLE_UNDERLINE) ; 

/* Ecriture du texte en italique et souligne */ 

texte = TTF_RenderText_Blended(police, "Salut les ZerOs !", couleurNoire) ; 

Resultat, le texte est ecrit en italique et souligne (fig. 26.8). 




Figure 26.8 - Ecriture en italique et souligne 

Pour restaurer une police a son etat normal, il suffit de refaire appel a la fonction 
TTF_SetFontStyle en utilisant cette fois le flag TTF_STYLE_NORMAL. 

Exercice : le compteur 

Cet exercice va cumuler ce que vous avez appris dans ce chapitre et dans le chapitre sur 
la gestion du temps. Votre mission, si vous l'acceptez, consistera a creer un compteur 
qui s'incrementera tous les dixiemes de seconde. 
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Ce compteur va done progressivement afficher : 0, 100, 200, 300, 400, etc. Au bout 
d'une seconde le nombre 1000 devrait done s'afficher. 



Astuce pour ecrire dans une chaine 

Pour realiser cet exercice, vous aurez besoin de savoir comment ecrire dans une chaine 
de caracteres en memoire. En effet, vous devez donner un char* a TTF_RenderText 
mais vous, ce que vous aurez, e'est un nombre (un int par exemple). Comment convertir 
un nombre en chame de caracteres ? 

On peut utiliser pour cela la fonction sprintf . Elle marche de la meme maniere que 
fprintf , sauf qu'au lieu d'ecrire dans un fichier elle ecrit dans une chaine 7 . Le premier 
parametre que vous lui donnerez sera done un pointeur sur un tableau de char. 



© 



Veillez a reserver suffisamment d'espace pour le tableau de char si vous ne 
voulez pas deborder en memoire I 



Exemple : 

I sprintf (temps , "Temps : */,d", compteur); 

Ici, temps est un tableau de char (20 caracteres), et compteur est un int qui contient 
le temps. Apres cette instruction, la chaine temps contiendra par exemple "Temps : 
500". 

A vous de jouer ! 

Correction 

Voici une correction possible de l'exercice : 

int main(int argc, char *argv[]) 
{ 

SDL_Surface *ecran = NULL, *texte = NULL; 

SDL_Rect position; 

SDL_Event event ; 

TTF_Font *police = NULL; 

SDL_Color couleurNoire = {0, 0, 0}, couleurBlanche = {255, 255, 255}; 

int continuer = 1 ; 

int tempsActuel = 0, tempsPrecedent = 0, compteur = 0; 

char temps [20] = ""; /* Tableau de char suffisamment grand */ 

SDL_Init(SDL_INIT_VIDEu) ; 
TTF_Init(); 



7. Le « s » de sprintf signifie « string », e'est-a-dire « chaine » en anglais. 
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ecran = SDL_SetVideoMode(640, 480, 32, SDL_HWSURFACE I SDL_D0UBLEBUF) ; 
SDL_WM_SetCaption("Gestion du texte avec SDL_ttf", NULL); 

/* Chargement de la police */ 

police = TTF_0penFont ("angelina.ttf " , 65); 

/* Initialisation du temps et du texte */ 

tempsActuel = SDL_GetTicks() ; 

sprintf (temps , "Temps : */,d" , compteur) ; 

texte = TTF_RenderText_Shaded(police, temps, couleurNoire, couleurBlanche) ; 

while (continuer) 
{ 

SDL_PollEvent(&event) ; 
switch(event .type) 
{ 

case SDL_QUIT: 

continuer = 0; 
break; 
} 

SDL_FillRect (ecran, NULL, SDL_MapRGB(ecran->f ormat , 255, 255, 255)); 

tempsActuel = SDL_Get Ticks () ; 

if (tempsActuel - tempsPrecedent >= 100) /* Si 100 ms au moins se sont 
°-> ecoulees */ 
{ 

compteur += 100; /* On rajoute 100 ms au compteur */ 
sprintf (temps, "Temps : '/,d" , compteur); /* On ecrit dans la chaine 
°-> "temps" le nouveau temps */ 

SDL_FreeSurf ace (texte) ; /* On supprime la surface precedente */ 
texte = TTF_RenderText_Shaded(police, temps, couleurNoire, 
c -» couleurBlanche) ; /* On ecrit la chaine temps dans la SDL_Surface */ 

tempsPrecedent = tempsActuel; /* On met a jour le tempsPrecedent */ 



position. x = 180; 

position. y = 210; 

SDL_BlitSurf ace (texte, NULL, ecran, ftposition) ; /* Blit du texte */ 

SDL_Flip (ecran) ; 



TTF_CloseFont (police) ; 
TTF_Quit() ; 

SDL_FreeSurf ace (texte) ; 
SDL_Quit() ; 

return EXIT_SUCCESS; 
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l> 



> [Code web : 913107) 

La fig. 26.9 vous presente le resultat au bout de 13,9 secondes tres exactement. 



u^MEammmnaii 



^m 



Temps : 13900 



Figure 26.9 - Le compteur au bout de 13,9 secondes 

N'hesitez pas a telecharger ce projet si vous souhaitez l'etudier en detail et l'ameliorer. 
II n'est pas encore parfait : on pourrait par exemple utiliser SDL_Delay pour eviter 
d'utiliser 100 % du CPU. 

t> ( Code web : 765629 ) 



Pour aller plus loin 

Si vous voulez ameliorer ce petit bout de programme, vous pouvez essayer d'en faire 
un jeu ou il faut cliquer le plus de fois possible dans la fenetre avec la souris dans un 
temps imparti. Un compteur s'incrementera a chaque clic de la souris. 

Un compte a rebours doit s'afficher. Lorsqu'il atteint 0, on recapitule le nombre de clics 
effectues et on demande si on veut faire une nouvelle partie. 

Vous pouvez aussi gerer les meilleurs scores en les enregistrant dans un fichier. Cela 
vous fera travailler a nouveau la gestion des fichiers en C. 

Bon courage ! 
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En resume 

- On ne peut pas ecrire de texte en SDL, a moins d'utiliser une extension comme la 
bibliotheque SDL_ttf . 

- Cette bibliotheque permet de charger un fichier de police au format . ttf a l'aide de 
la fonction TTF_OpenFont. 

- II y a trois modes d'ecriture du texte, du plus simple au plus sophistique : Solid, 
Shaded et Blended. 

- On ecrit dans une SDL_Surf ace via des fonctions comme TTF_RenderText_Blended. 
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Chapitre 



27 



Jouer du son avec FMOD 



Difficulty : WB 

Depuis que nous avons decouvert la SDL, nous avons appris a placer des images dans 
la fenetre, a faire interagir I'utilisateur avec le clavier et la souris, a ecrire du texte, 
mais il manque clairement un element : le son I 

Ce chapitre va combler ce manque. Parce que les possibilites offertes par la SDL en matiere 
d'audio sont tres limitees, nous allons decouvrir ici une bibliotheque specialisee dans le son : 
FMOD. 
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FMOD est sans aucun doute une des meilleures bibliotheques audio qui existent a ce 
jour. II aurait ete possible de travailler avec le module audio de la SDL, mais etant donne 
ses limitations 1 il sera bien plus interessant pour nous d'installer une bibliotheque 
specialisee dans le domaine, comme FMOD. 



Installer FMOD 



Telecharger FMOD 



Pour telecharger la bibliotheque, il faut vous rendre sur son site officiel. 
t> ( Code web : 478391 ) 



A 



FMOD est une bibliotheque gratuite mais pas sous license LGPL, contrai- 
rement a la SDL. Cela signifie que vous pouvez I'utiliser gratuitement du 
moment que vous ne I'utilisez pas pour realiser un programme payant 2 . Si 
vous voulez faire payer votre programme, il faudra payer une redevance a 
I'auteur (je vous laisse consulter les prix sur le site de FMOD). 



Rendez-vous sur la page des telechargements (Downloads) et prenez FMOD 3. 

Attention : il y a plusieurs versions de FMOD, et en particulier une plus recente, appelee 
FMOD Ex (il s'agit en fait de FMOD 4). Toutefois, FMOD Ex est une bibliotheque 
C++, contrairement a FMOD 3 qui est une bibliotheque C. 

Installer FMOD 

Le fichier que vous avez telecharge est un fichier ZIP 3 . L'installation se deroule de la 
meme maniere qu'avec les autres bibliotheques qu'on a vues jusqu'ici. 

1. Vous avez un dossier Api avec la DLL de FMOD (fmod.dll) a placer dans le 
repertoire de votre projet. 

2. Dans le dossier api/inc, vous trouverez les .h. Placez-les a cote des autres .h 
dans le dossier de votre IDE. Par exemple Code Blocks/mingw32/include/FM0D 
(j'ai cree un dossier special pour FMOD comme pour SDL). 

3. Dans le dossier api/lib, recuperez le fichier qui correspond a votre compilateur. 
- Si vous utilisez Code: :Blocks, done le compilateur mingw, copiez libfmod.a 

dans le dossier lib de votre IDE. Dans le cas de Code: :Blocks, e'est le dossier 
CodeBlocks/mingw32/lib. 



1. On ne peut jouer que des sons WAV, par exemple. 

2. On notera que de nombreux jeux celebres font partie des utilisateurs de FMOD, comme World 
of Warcraft, Need for Speed, Wolfenstein. . . FMOD fonctionne par ailleurs sur un tres grand nombre 
de plates-formes, particulierement sur des consoles de jeux comme la XBOX 360, la PS2, la PS3, la 
PSP, la Wii, etc. 

3. Si e'est un executable, e'est que vous avez pris FMOD Ex et non FMOD 3 ! 
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- Si vous utilisez Visual C++, recuperez le fichier fmodvc.lib. 

Enfin, et c'est peut-etre le plus important, dans le dossier documentation vous 
trouverez un fichier d'aide qui correspond a la documentation de FMOD. Je vous 
conseille de le placer quelque part sur votre disque dur et d'en faire un raccourci 
bien visible. En effet, la documentation liste toutes les possibilites de FMOD dans 
le detail. Dans ce chapitre, on ne pourra en voir que les principales. Si vous voulez 
allez plus loin, il faudra done vous plonger dans cette doc'. 



II reste a configurer notre projet. La encore, c'est comme d'habitude : vous ouvrez 
votre projet avec votre IDE favori et vous ajoutez le fichier .a (ou .lib) a la liste 
des fichiers que le linker doit recuperer. Sous Code: :Blocks, menu Project / Build 
Options, onglet Linker, cliquez sur Add et indiquez ou se trouve le fichier .a. Si on 
vous demande Keep as a relative path ?, je vous conseille de repondre par la negative, 
mais dans les deux cas <ja devrait de toute maniere marcher. 

FMOD est installee, voyons rapidement de quoi elle est constitute. 



Les differentes sections de FMOD 

FMOD 3 est en fait la combinaison de deux bibliotheques : 

- FSOUND : cette partie gere tous les sons de type PCM. II s'agit tout simplement de 
sons « reels » enregistres ; cela comprend aussi bien les formats compresses que non 
compresses : WAV, MP3, OGG, etc. Ces sons peuvent etre des musiques ou des sons 
de courte duree comme des bruits de pas, de balle. . . D'ailleurs, FMOD distingue 
deux types de sons : 

- les sons courts (bruit de pas, bruit de balle) destines a etre repetes souvent, 

- les sons longs, comme une musique durant par exemple 3 minutes (qui peut etre 
la musique de fond de votre jeu) ; 

- FMUSIC : cette section gere les musiques au format binaire. Cette fois, il n'y a 
pas de son enregistre, juste des notes de musique. Le format binaire le plus connu 
est probablement le MIDI. Vous savez probablement que les MIDI sont des fichiers 
audio de petite taille : c'est justement parce qu'ils enregistrent seulement les notes 
de musique (il ne peut done pas y avoir de « paroles » avec un tel format de fichier). 
Cette section peut etre tres utile pour jouer de vieilles musiques type Gameboy ou 
SuperNES, comme par exemple la musique de Super Mario, de Tetris, etc. 

Dans ce chapitre, nous verrons les trois types de sons car ils se chargent et se lisent 
avec des fonctions differentes : 

- FSOUND : sons courts ; 

- FSOUND : sons longs (musiques) ; 

- FMUSIC : musique type MIDI. 

445 



CHAPITRE 27. J OVER DU SON AVEC FMOD 



Initialiser et liberer FMOD 

Comme la plupart des bibliotheques ecrites en C, il faut charger (on dit aussi « initia- 
liser ») FMOD et la liberer quand on n'en a plus besoin. A ce niveau, <ja ne devrait 
pas beaucoup vous changer de la SDL. 

Inclure le header 

Avant toute chose — vous avez du le faire instinctivement mais <ja ne coute rien de le 
preciser — : il faut inclure le fichier .h de FMOD. 

| #include <FM0D/fmod.h> 

J'ai place ce fichier dans un sous-dossier FMOD. Adaptez cette ligne en fonction de la 
position du fichier si chez vous c'est different. 

Initialiser FMOD 

On initialise FMOD avec la fonction FSOUND_Init. Elle prend 3 parametres. 

- La frequence d'echantillonnage : ce parametre permet d'indiquer la qualite de 
son que doit gerer FMOD. Plus la frequence est elevee, meilleur est le son (mais plus 
grande est la puissance demandee). Voici quelques exemples de frequences pour vous 
aider a faire votre choix. 

- Qualite CD : 44 100 Hz 

- Qualite radio : 22 050 Hz 

- Qualite telephonique : 11 025 Hz 

Tout au long de ce chapitre, nous utiliserons une frequence de 44 100 Hz 4 . 

- Le nombre maximal de canaux que devra gerer FMOD. En d'autres termes, 
c'est le nombre maximal de sons qui pourront etre joues en meme temps. Tout 
depend de la puissance de votre carte son. On conseille generalement une valeur de 
32 (ce sera suffisant pour la plupart des petits jeux). Pour information, FMOD peut 
theoriquement gerer jusqu'a 1024 canaux differents, mais a ce niveau ga risque de 
faire beaucoup travailler votre ordinateur ! 

- Enfin, on peut indiquer des flags. II n'y a rien de bien interessant a mettre en 
general, on se contentera done d'envoyer (pas de flags). 

Nous pouvons done initialiser FMOD comme ceci : 

|FS0UND_Init (44100, 32, 0); 

Ce qui signifie : frequence de 44 100 Hz (qualite CD au mieux), 32 canaux et pas 
d'options particulieres (flag = 0). 



4. Si le son que vous utilisez est de mauvaise qualite a la base, FMOD ne l'ameliorera pas. Par 
contre, si vous avez un son de frequence 44 100 Hz et que FMOD utilise une frequence de 22 050 Hz, 
sa qualite sera diminuee. 
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Liberer FMOD 

On arrete FMOD de la maniere la plus simple qui soit : 

|FS0UND .Close ; 

Est-ce que j'ai vraiment besom de commenter ce code? ;-) 

Les sons courts 

Nous commencerons par etudier les sons courts. Un « son court », comme je l'appelle, 
est un son qui dure generalement quelques secondes (parfois moins d'une seconde) et 
destine a etre joue regulierement. 

Quelques exemples de sons courts : 

- un bruit de balle ; 

- un bruit de pas ; 

- un tic-tac (pour faire stresser le joueur avant la fin d'un compte a rebours !) ; 

- des applaudissements ; 

- etc. 

Bref, <ja correspond dans les grandes lignes a tous les sons qui ne sont pas des mu- 
siques. Generalement, ces sons sont tenements courts qu'on ne prend pas la peine de 
les compresser. On les trouve done le plus souvent au format WAV non compresse. 

Trouver des sons courts 

Avant de commencer, il faudrait faire le plein de sons. De nombreux sites proposent 
justement des banques de sons. 

Si vous faites une recherche a l'aide de l'expression « Free Sounds » avec Google (« sons 
gratuits » en anglais), vous obtenez des centaines de millions de resultats ! Rien qu'avec 
les sites de la premiere page, vous devriez trouver votre bonheur. Personnellement, j'ai 
retenu FindSounds.com, un moteur de recherche pour sons. 

> ( Code web : 876870 ) 

En recherchant « gun », on trouve des tonnes de sons de tir de fusil ; en tapant « foots- 
teps » on trouve des bruits de pas, etc. 

Les etapes a suivre pour jouer un son 

La premiere etape consiste a charger en memoire le son que vous voulez jouer. II est 
conseille de charger tous les sons qui seront frequemment utilises dans le jeu des le 
debut du programme. Vous les libererez a la fin. En effet, une fois que le son est charge 
en memoire, sa lecture est tres rapide. 
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Le point eur 

Premiere etape : creer un pointeur de type FSOUND_SAMPLE qui representera notre son. 
| FSOUND_SAMPLE *tir = NULL; 

Charger le son 

Deuxieme etape : charger le son avec la fonction FSOUND_Sample_Load. Elle prend. . . 
5 parametres. 

- Le numero de la sample pool dans laquelle FMOD doit garder une trace du son. 
Je m'explique : la sample pool est une sorte de tableau dans lequel FMOD garde une 
copie des pointeurs vers chacun des sons courts charges. Cela lui permet de liberer 
automatiquement la memoire lorsqu'on appelle FSOUND_Close() (la fonction d'arret 
de FMOD) : il suffit a FMOD de lire ce tableau et de liberer chacun des elements qui 
s'y trouvent. Toutefois, plutot que de faire confiance a FMOD, il vaut mieux penser a 
appeler nous-memes la fonction de liberation de memoire (FSOUND_Sample_Free()) 
que nous allons decouvrir dans quelques instants. Pour indiquer un numero de la 
sample pool, le mieux est d'envoyer FSOUND_FREE a la fonction. Elle se chargera 
alors d'occuper le premier emplacement libre de la sample pool qu'elle trouvera. 

- Le nom du fichier son a charger. II peut 6tre de format WAV, MP3, OGG, etc. 
Toutefois, il vaut mieux charger des sons courts (quelques secondes maximum) plutot 
que des sons longs. En effet, la fonction chargera et decodera tout le son en memoire, 
ce qui peut prendre de la place si le son est une musique ! 

- Le troisieme parametre ne nous interesse pas : il permet de preciser les caracteris- 
tiques du fichier qu'on veut charger (frequence d'echantillonnage, etc.). Or, dans 
le cas des WAV, MP3, OGG et C le , ces informations sont inscrites dans le fichier. 
On va done envoyer la valeur pour ne rien preciser. 

- V offset ou doit commencer la lecture. Cela permet de commencer la lecture du son 
a un moment precis. Mettez pour commencer du debut. 

- La longueur : si vous precisez un offset, il faudra aussi donner la longueur de son 
a lire. On mettra la encore car on veut tout lire. 

La fonction renvoie l'adresse memoire a laquelle a ete charge le son. Voici un exemple 
de chargement : 

|tir = FSOUND_Sample_Load(FSOUND_FREE, "pan.wav", 0, 0, 0); 

Ici, je charge le son pan.wav et je le place dans le premier canal libre. Le pointeur tir 
fera reference a ce son par la suite. Vous remarquerez qu'en regie generale on laisse les 
3 derniers parametres a 0. 

Je vous invite a telecharger ce pan.wav pour faire des tests en meme temps que vous 
lisez ce chapitre. 



Code web : 252603 



La fonction renvoie NULL si le fichier n'a pas ete charge. Vous avez tout interet a verifier 
si le chargement a reussi ou s'il a echoue. 
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Jouer le son 

Vous voulez jouer le son? Pas de probleme avec la fonction FSOUND_PlaySound ! II 
suffit de lui donner un numero de canal sur lequel le jouer ainsi que le pointeur sur le 
son. Pour le numero de canal, ne vous prenez pas la tete et envoyez FSOUND_FREE pour 
laisser FMOD gerer ga. 



| FSOUND_PlaySound(FSOUND_FREE, tir) ; 



Liberer le son de la memoire 



Lorsque vous n'avez plus besoin du son, vous devez le liberer de la memoire. II n'y a 
rien de plus simple, il suffit d'indiquer le pointeur a liberer avec FSOUND_Sample_Free : 

| FSOUND_Sample_Free(tir) ; 



Exemple : un jeu de tir 

Le mieux maintenant est de resumer tout ce qu'on a vu dans un cas concret de pro- 
gramme ecrit en SDL. II n'y avait rien de complique et, normalement, vous ne devriez 
avoir aucune difficult e a realiser cet exercice. 



Le sujet 

Le but est simple : creer un jeu de tir. On ne va pas realiser un jeu complet ici, mais 
juste la gestion du viseur. Je vous propose de telecharger le viseur de la fig. 27.1 que 
j 'ai amoureusement realise moi-meme sous Paint 5 . 

o 

Figure 27.1 - Le viseur 

Voila les objectifs. 

- Fond de fenetre : noir. 

- Pointeur de la souris : invisible. 

- L'image du viseur est blittee a la position de la souris lorsqu'on la deplace. Attention : 
il faut que le CENTRE de l'image soit place au niveau du pointeur de la souris. 

- Quand on clique, le son pan.wav doit etre joue. 

Ca peut etre le debut d'un jeu de tir. 
Trop facile ? Ok, alors a vous de jouer ! 



5. Oui, je sais. . . J'aurais du faire les Beaux Arts. 
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La correction 

Voici le code complet : 

#include <stdlib.h> 

#include <stdio.h> 

#include <SDL/SDL.h> 

#include <SDL/SDL_image .h> 

#include <FM0D/fmod.h> 

int main(int argc, char *argv[]) 
{ 

SDL_Surface *ecran = NULL, *viseur = NULL; 

SDL_Event event ; 

SDL_Rect position; 

int continuer = 1 ; 

FSOUND_SAMPLE *tir = NULL; 

/* Initialisation de FMOD */ 
FSOUND_Init (44100, 32, 0); 

/* Chargement du son et verification du chargement */ 

tir = FSOUND_Sample_Load(FSOUND_FREE, "pan.wav", 0, 0, 0); 

if (tir == NULL) 

{ 

fprintf (stderr, "Impossible de lire pan.wav\n"); 

exit(EXIT_FAILURE) ; 
} 

/* Initialisation de la SDL */ 
SDL_Init(SDL_INIT_VIDE0) ; 

SDL_ShowCursor(SDL_DISABLE) ; 

ecran = SDL_SetVideoMode(640, 480, 32, SDL_HWSURFACE I SDL_D0UBLEBUF) ; 

SDL_WM_SetCaption("Gestion du son avec FMOD", NULL); 

viseur = IMG_Load("viseur .png") ; 

while (continuer) 
{ 

SDL_WaitEvent (ftevent) ; 

switch(event . type) 
{ 

case SDL_QUIT: 

continuer = 0; 
break ; 
case SDL_M0USEBUTT0ND0WN: 

/* Lorqu'on clique, on joue le son */ 
FS0UND_PlaySound(FS0UND_FREE, tir); 
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break; 
case SDL_MOUSEMOTION: 

/* Lorsqu'on deplace la souris, on place le centre du viseur a 
=->• la position de la souris */ 

position. x = event .motion. x - (viseur->w / 2); 
position. y = event .motion. y - (viseur->h / 2); 
break; 



SDL_FillRect(ecran, NULL, SDL_MapRGB(ecran->f ormat , 0, 0, 0)); 
SDL_BlitSurface(viseur, NULL, ecran, ftposition) ; 
SDL_Flip(ecran) ; 



} 



/* On ferme la SDL */ 
SDL_FreeSurf ace (viseur) ; 
SDL_Quit() ; 

/* On libere le son et on ferme FMOD */ 
FSOUND_Sample_Free(tir) ; 
FS0UND_Close(); 

return EXIT_SUCCESS; 



Code web : 839759 



La fig. 27.2 vous donne un apergu du mini-jeu, mais le mieux est encore de voir le 
resultat en video avec le son sur le web ! 

> ( Code web : 317872 ) 

Ici, j'ai charge FMOD avant la SDL et je l'ai liberee apres la SDL. II n'y a pas de regies 
au niveau de l'ordre (j'aurais tout aussi bien pu faire l'inverse). J'ai choisi de charger 
la SDL et d'ouvrir la fenetre apres le chargement de FMOD pour que le jeu soit pret a 
etre utilise des que la fenetre s'ouvre, sinon il aurait peut-etre fallu attendre quelques 
millisecondes le temps que FMOD se charge. 

Le code est, je pense, suffisamment commente. II n'y a pas de piege particulier, pas de 
nouveaute fracassante. 

On notera la « petite » difficulte qui consistait a blitter le centre du viseur au niveau 
du pointeur de la souris. Le calcul de la position de l'image est fait en fonction de cela. 



Idees d'amelioration 

Ce code est la base d'un jeu de shoot. Vous avez le viseur, le bruit de tir, il ne vous 
reste plus qu'a faire apparaitre ou defiler des ennemis et a marquer le score du joueur. 
Comme d'habitude, c'est a vous de jouer. Vous vouliez faire un jeu? Qu'a cela ne 
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Figure 27.2 - Apergu du mini-jeu du viseur 



tienne, vous avez le niveau maintenant 6 et meme un code de base pour demarrer un 
jeu de tir ! Qu'est-ce que vous attendez ? ;-) 



Les musiques (MP3, OGG, WMA. . .) 

En theorie, la fonction FSOUND_Sample_Load permet de charger n'importe quel type 
de son, y compris les formats compresses MP3, OGG, WMA. Le probleme concerne 
les sons « longs », c'est-a-dire les musiques. En effet, une musique dure en moyenne 
3 a 4 minutes. Or, la fonction FSOUND_Sample_Load charge tout le fichier en memoire 
(et c'est la version decompressee qui est mise en memoire, <ja prend done beaucoup de 
place !). 

Si vous avez un son long (on va parler de « musique » dorenavant), il est preferable de 
le charger en streaming, c'est-a-dire d'en charger des petits bouts au fur et a mesure 
de la lecture. C'est ce que font tous les lecteurs audio. 



6. Bien sur, les forums du Site du Zero (code web : 473573) sont toujours la pour vous aider si vous 
etes bloques a un moment de la creation de votre jeu. II est normal de rencontrer des difficultes, quel 
que soit le niveau qu'on ait ! 
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Trouver des musiques 

Je vous propose d'utiliser des chansons libres de droits dans vos programmes 7 . Les au- 
teurs vous autorisent a diffuser librement leurs chansons, il n'y a done aucun probleme 
pour que vous les utilisiez dans vos programmes. 



A 



Si votre programme est payant, il faudra en parler a I'artiste a moins que 
celui-ci n'autorise explicitement une utilisation commerciale de son oeuvre. 
Une chanson libre de droits peut etre telechargee, copiee et ecoutee librement, 
mais ca ne veut pas dire qu'on vous autorise a vous faire de I'argent sur le 
dos des artistes I 



Pour telecharger des musiques libres, je vous recommande Jamendo, un des sites que 
je prefere, bien que ce soit pas le seul qui existe dans le domaine. 



Code web : 407732 



Les chansons sont classees par style. Vous avez beaucoup de choix. On y trouve de tout. 

Je vais utiliser une chanson du groupe Hype 8 de l'album « Lies and Speeches », intitulee 
« Home ». Vous pouvez la telecharger au format MP3. 



Code web : 926208 



Les etapes a suivre pour jouer une musique 

Comme d'habitude, il faut que FMOD soit charge avec FS0UND_Init et decharge avec 
FS0UND_Close. 



Le pointeur 

Cette fois, le pointeur doit etre de type FS0UND_STREAM. 

| FS0UND_STREAM *musique = NULL; 

Charger le son 

Comme je vous l'ai dit, le son sera charge progressivement (on dit en streaming) . Tou- 
tefois, il faut quand meme ouvrir le fichier, car pour l'instant notre pointeur musique 
vaut toujours NULL, je vous rappelle. 

On utilise ici la fonction FS0UND_Stream_0pen. Elle prend 4 parametres, ce sont les 4 
memes derniers parametres que ceux de la fonction FSOUND_Sample_Load qu'on a vue 



7. Vous n'etes pas sans savoir qu'il faut verser une redevance pour pouvoir utiliser la plupart des 
chansons que vous connaissez ! 

8. Vous pouvez retrouver Hype sur leur page MySpace si vous voulez en savoir plus (code web : 
839250). 
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tout a l'heure. En clair, indiquez le nom du fichier a ouvrir dans le premier parametre, 
et laissez les 3 autres parametres a 0. 

La fonction retourne une adresse memoire qu'on recupere avec notre pointeur musique. 

I musique = FSOUND_Stream_Open("Hype_Home .mp3" , 0, 0, 0); 

II est la encore fortement conseille de verifier si le fichier a bien ete charge. En cas 
d'echec, le pointeur vaut NULL. 

Jouer la musique 

C'est tres simple : on fait appcl a FSOUND_Stream_Play. Elle prend 2 parametres : 

- Le numero du canal sur lequel jouer le son (envoyez FS0UND_FREE et FMOD se 
debrouillera tout seul pour trouver un canal libre) 

- Le pointeur vers le fichier a lire (dans notre cas, il s'appellc musique). 

On peut done jouer notre musique avec : 

| FSOUND_Stream_Play(FSOUND_FREE, musique) ; 

Et voila le travail ! 

Mais ce n'est pas tout. Dans le cas d'une musique, il peut etre bien de savoir modifier 
le volume, gerer les repetitions de la chanson, la mettre en pause ou meme l'arreter. 
C'est ce genre de choses que nous allons apprendre a faire maintenant. 

Modifier le volume 

Avec la fonction FSOUND_SetVolume, vous pouvez changer le volume d'un canal. 
| FSOUWD_SetVolume(FSOUWD_ALL, 120) ; 

II faut envoyer 2 parametres : 

- Le numero du canal dont on doit changer le volume (pour changer le volume de tous 
les canaux, envoyez FS0UND_ALL) 

- Le nouveau volume : indiquez un nombre de (silencieux) a 255 (volume maximal) 

Notez que cette fonction permet aussi de changer le volume des sons courts, 
et pas seulement celui des sons streames (longs). 



Repetition de la chanson 

On a souvent besoin de repeter la musique de fond. C'est justement ce que propose la 
fonction FSOUND_Stream_SetLoopCount. Elle prend 2 parametres : 
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- Le pointeur vers la chanson 

- Le nombre de fois qu'elle doit etre repetee. Si vous mettez 1, la chanson sera done 
repetee une seule fois. Si vous mettez un nombre negatif (comme -1), elle sera jouee 
indefmiment. 

Avec ce code source, notre musique sera done repetee a l'infmi : 

| FSOUND_Stream_SetLoopCount (musique, -1) ; 

Pour que la repetition fonctionne, il faut envoyer FS0UND_L00P_N0RMAL en second pa- 
rametre de la fonction FSOUND_Stream_Open. 

Mettre en pause la chanson 

II y a ici 2 fonctions a connaitre : 

- FSOUND_GetPaused(numero_du_canal) : indique si la chanson jouee sur le canal 
indique est en pause ou non. Elle renvoie « vrai » si la chanson est en pause, « faux » 
si elle est en train d'etre jouee. 

- FSOUND_SetPaused(numero_du_canal, etat) : met en pause ou reactive la lecture 
de la chanson sur le canal indique. Envoyez 1 (« vrai ») pour mettre en pause, 
(« faux ») pour reactiver la lecture. 

Ce morceau de code de fenetre SDL met en pause la chanson si on appuie sur P, et la 
reactive si on appuie a nouveau sur P ensuite. 

case SDL_KEYDOWN: 

if (event .key .keysym.sym == SDLK_p) // Si on appuie sur P 
{ 

if (FSOUND_GetPaused(l)) // Si la chanson est en pause 

FSOUND_SetPaused(FSOUND_ALL, 0); // On enleve la pause 
else // Sinon, elle est en cours de lecture 

FSOUND_SetPaused(FSOUND_ALL, 1); // On met en pause 
} 
break ; 

Stopper la lecture 

II suffit d'appeler FSOUND_Stream_Stop. On lui envoie le pointeur vers la chanson a 
arret er. 

| FSOUND_Stream_Stop(musique) ; 

Et bien d'autres choses 

On peut faire beaucoup d'autres choses, mais je ne vais pas toutes vous les enumerer 
ici, autant repeter la doc' ! Je vous invite done a la lire si vous cherchez des fonctions 
supplementaires . 
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Liberer la memoire 

Pour decharger la musique de la memoire, appelez FSOUND_Stream_Close et donnez-lui 
le pointeur. 

| FSOUND_Stream_Close (musique) ; 

Code complet de lecture du MP3 

Le code ci-dessous vous montre un programme jouant la musique « Home ». La musique 
est jouee des le debut du programme. On peut la mettre en pause en appuyant sur P. 

int main(int argc, char *argv[]) 
{ 

SDL_Surface *ecran = MULL, *pochette = NULL; 

SDL_Event event ; 

SDL_Rect position; 

int continuer = 1 ; 

FSOUND_STREAM *musique = NULL; 

FSOUND_Init (44100, 32, 0); 

/* On ouvre la musique */ 

musique = FSOUND_Stream_Open("Hype_Home .mp3" , FS0UND_L00P_N0RMAL, 0, 0); 

if (musique == NULL) /* On verifie si elle a bien ete ouverte (IMPORTANT) */ 

{ 

fprintf (stderr, "Impossible de lire Hype_Home.mp3\n") ; 

exit(EXIT_FAILURE) ; 
} 

FSOUND_Stream_SetLoopCount (musique, -1); /* On active la repetition de la 
<— ¥ mus ique a 1 ' inf ini * / 

FS0UND_Stream_Play(FS0UND_FREE, musique); /* On joue la musique */ 

SDL_Init(SDL_INIT_VIDE0) ; 

ecran = SDL_SetVideoMode(640, 480, 32, SDL_HWSURFACE I SDL_D0UBLEBUF) ; 

SDL_WM_SetCaption("Gestion du son avec FMOD", NULL); 
pochette = IMG_Load("hype_liesandspeeches . jpg") ; 
position. x = 0; 
position. y = 0; 

while (continuer) 
{ 

SDL_WaitEvent(&event) ; 
switch(event . type) 
{ 

case SDL_QUIT: 

continuer = 0; 
break ; 
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case SDL_KEYDOWN: 

if (event .key .keysym. sym == SDLK_p) //Si on appuie sur P 
{ 

if (FSOUND_GetPaused(l)) // Si la chanson est en pause 

FSOUND_SetPaused(l, 0); // On enleve la pause 
else // Sinon, elle est en cours de lecture 

FSOUND_SetPaused(l, 1); // On active la pause 
} 

break; 
} 

SDL_FillRect(ecran, NULL, SDL_MapRGB(ecran->f ormat , 0, 0, 0)); 
SDL_BlitSurf ace (pochette, NULL, ecran, ^position) ; 
SDL_Flip(ecran) ; 



} 



FSOUND_Stream_Close (musique) ; /* On libere la memoire */ 
FSOUND_Close(); 

SDL_FreeSurf ace (pochette) ; 
SDL_0uit() ; 

return EXIT_SUCCESS; 



> ( Code web : 763860 ) 

Histoire d'avoir autre chose qu'une fenetre noire, j'ai mis la pochette de l'album en 
image de fond. 

Pour apprecier pleinement le resultat, je vous invite a regarder la video du programme 
en cours d'execution. 



> Code web : 517526 



Les musiques (MIDI) 



Les musiques de type MIDI sont tres differentes des musiques de type MP3, OGG ou 
WMA qu'on vient d'etudier. En effet, au lieu d'enregistrer la musique avec un micro, 
cette fois la musique est creee de toutes pieces sur l'ordinateur. On n'enregistre que des 
notes de musique, ce qui explique pourquoi on ne peut pas enregistrer la voix. 

L'avantage? En enregistrant uniquement les notes, on obtient des fichiers tres tres 
petits. Vous avez peut-etre deja remarque que les MIDI etaient de tous petits fichiers. 
Le defaut ? Eh bien on ne peut pas enregistrer de voix et les effets autorises par le 
format, bien que nombreux, sont limites. 

Ce format est done inadapte pour enregistrer des musiques qui passent a la radio, 
par exemple; en revanche, il est tout a fait adapte pour jouer de vieilles musiques de 
l'epoque de la Super-NES, GameBoy, MegaDrive, etc. 
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Trouver des MIDI 

On trouve des kilotonnes de MIDI sur le net. Je ne m'en fais pas pour vous, vous 
trouverez votre bonheur ! 

Personnellement, j'ai retenu MusicRobot.com, un moteur de recherche pour fichiers 
MIDI. 

t> ( Code web : 833286 ) 

Personnellement, j'ai recupere une vieille musique de Mario (ah, les souvenirs!). Vous 
pouvez la telecharger pour vos tests si vous le voulez. 

t> ( Code web : 416197) 

Les etapes a suivre pour jouer un MIDI 

Les fonctions necessaires pour jouer des MIDI commencent par le prefixe FMUSIC au 
lieu de FSOUND. Toutefois, les fonctions de chargement et de dechargement de FMOD 
a utiliser restent les memes et elles ont bien le prefixe FSOUND. 

Vous commencez a avoir l'habitude, je vais done aller maintenant un peu plus vite dans 
le listing des fonctions. 

Le point eur 

| FMUSIC_MODULE *musique = NULL; 

Charger un MIDI 

I musique = FMUSIC_LoadSong("mario.mid") ; 

La fonction prend un seul parametre : comme vous le voyez, e'est encore plus simple. 
Elle renvoie NULL si le fichier n'a pas pu etre charge. 

Jouer un MIDI 

| FMUSIC_PlaySong (musique) ; 

Repeter un MIDI 

| FMUSIC_SetLooping(musique, 1); 

Cette fois, e'est un peu different. II faut envoyer 1 (« vrai ») pour que la musique soit 
repetee a l'infini. 
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Mettre en pause un MIDI 

La fonction FMUSIC_GetPaused indique si la chanson est en pause ou non. 

| FMUSIC_GetPaused(musique) ; 

La fonction FMUSIC_SetPaused met en pause ou reactive la lecture de la chanson. 

| FMUSIC_SetPaused(musique, 1); 

Envoyez 1 pour mettre en pause, pour relancer la lecture. 
Voici un exemple de code gerant la pause si on appuie sur P : 

case SDL_KEYDOWN: 

if (event .key .keysym.sym == SDLK_p) //Si on appuie sur P 
{ 

if (FMUSIC_GetPaused(musique) ) // Si la chanson est en pause 

FMUSIC_SetPaused(musique, 0) ; // On enleve la pause 
else // Sinon, elle est en cours de lecture 

FMUSIC_SetPaused(musique, 1) ; // On active la pause 



© 



Attention : bien que similaire, ce code est different du code de pause qu'on 
a vu tout a I'heure. En particulier, il n'y a pas de canal a indiquer ici. 



Modifier le volume 

| FMUSIC_SetMasterVolume(musique, 150) ; 

Le second parametre correspond au volume. 

- = silencieux 

- 256 = volume maximal 

Stopper la lecture 

| FMUSIC_StopSong(musique) ; 

Liberer la musique MIDI 

| FMUSIC_FreeSong(musique) ; 
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Code d'exemple pour resumer 

int main(int argc, char *argv[]) 
{ 

SDL_Surface *ecran = NULL, *niveau = NULL; 

SDL_Event event ; 

SDL_Rect position; 

int continuer = 1 ; 

FMUSIC_MODULE *musique = NULL; 

FSOUND_Init (44100, 32, 0); 

musique = FMUSIC_LoadSong("mario .mid") ; // Chargement de la chanson 

if (musique == NULL) 

{ 

fprintf (stderr, "Impossible de lire mario .mid\n") ; 

exit(EXIT_FAILURE) ; 
} 

FMUSIC_SetLooping (musique, 1); // Repetition infinie 
FMUSIC_PlaySong(musique) ; // On joue la chanson 

SDL_Init(SDL_INIT_VIDEO) ; 

ecran = SDL_SetVideoMode(640, 480, 32, SDL_HWSURFACE I SDL_D0UBLEBUF) ; 
SDL_WM_SetCaption("Gestion du son avec FMOD", NULL); 
niveau = IMG_LoadCmario_niveau.jpg"); 
position. x = 0; 
position. y = 0; 

while (continuer) 
{ 

SDL_WaitEvent (ftevent) ; 
switch(event . type) 
{ 

case SDL_QUIT: 

continuer = 0; 
break ; 
case SDL_KEYD0WN: 

if (event .key .keysym.sym == SDLK_p) //Si on appuie sur P 
{ 

if (FMUSIC_GetPaused(musique) ) // Si la chanson est en pause 

FMUSIC_SetPaused(musique, 0) ; // On enleve la pause 
else // Sinon, elle est en cours de lecture 

FMUSIC_SetPaused(musique, 1) ; // On active la pause 
} 

break ; 
} 

SDL_FillRect (ecran, NULL, SDL_MapRGB(ecran->f ormat , 0, 0, 0)); 
SDL_BlitSurf ace (niveau, NULL, ecran, ftposition) ; 
SDL_Flip (ecran) ; 
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FMUSIC_FreeSong(musique) ; // Dechargement de la chanson 
FSOUND_Close(); 



SDL_FreeSurf ace (niveau) ; 
SDL_Quit() ; 

return EXIT_SUCCESS; 



} 



> ( Code web : 111949 ) 

Ce code reprend les fonctions principales qu'on vient de voir. 
Je vous propose de decouvrir ce que <ja donne en video 9 . 

> ( Code web : 120059) 

En resume 

- La SDL possede des fonctionnalites audio limitees et il est plutot conseille de se 
pencher sur une bibliotheque dediee au son, comme FMOD. 

- On distingue 3 types de sons avec FMOD : des sons courts, des sons longs (musiques 
MP3, OGG. . .) et des musiques au format binaire (MIDI). 

- Chacun de ces types se lit avec des fonctions differentes. II est conseille d'utiliser les 
fonctions adaptees et d'eviter de charger un son long comme si c'etait un son court, 
par exemple. 

- FMOD permet de jouer simultanement plusieurs sons differents a l'aide de canaux. 

- La frequence d'echantillonnage indique la qualite du son qui sera joue. 



9. La compression de la video a deteriore la qualite du MIDI original. 
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Chapitre 



28 



TP : visualisation spectrale du son 



Difficulty : UB 

Ce chapitre de travaux pratiques va vous proposer de manipuler la SDL et FMOD 
simultanement. Cette fois, nous n'allons pas travailler sur un jeu. Certes, la SDL est 
tout particulierement adaptee a cela, mais on peut I'utiliser dans d'autres domaines. 
Ce chapitre va justement vous prouver qu'elle peut servir a autre chose. 

Nous allons realiser ici une visualisation du spectre sonore en SDL. Cela consiste a afficher 
la composition du son que Ton joue, par exemple une musique. On retrouve cela dans de 
nombreux lecteurs audio. C'est amusant et ce n'est pas si complique que ca en a I'air! 
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Ce chapitre va nous permettre de travailler autour de notions que nous avons decou- 
vertes recemment : 

- la gestion du temps ; 

- la bibliotheque FMOD. 

Nous decouvrirons en outre comment modifier une surface pixel par pixel. 

La fig. 28.1 vous donne un apergu du programme que nous allons creer dans ce chapitre. 




Figure 28.1 - Visualisation du spectre sonore 

C'est le genre de visualisation qu'on peut retrouver dans des lecteurs audio tels que 
Winamp, Windows Media Player ou encore AmaroK. Et pour ne rien gacher, comme 
je vous l'ai dit ce n'est pas bien difficile a faire. D'ailleurs, contrairement au TP Mario 
Sokoban, cette fois c'est vous qui allez travailler. Ca vous fera un tres bon exercice. 



Les consignes 

Les consignes sont simples. Suivez-les pas a pas dans l'ordre et vous n'aurez pas d'en- 
nuis ! 

1. Lire un MP3 

Pour commencer, vous devez creer un programme qui lit un fichier MP3. Vous n'avez 
qu'a reprendre la chanson « Home » du groupe Hype que nous avons utilisee dans le 
chapitre sur FMOD pour illustrer le fonctionnement de la lecture d'une musique. 

> ( Code web : 926208 ) 
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Si vous avez bien suivi le chapitre sur FMOD, il ne vous faudra pas plus de quelques 
minutes pour arriver a le faire. Je vous conseille au passage de placer le MP3 dans le 
dossier de votre projet. 



2. Activer le module DSP de FMOD 

Je vous avais dit dans le chapitre sur FMOD que nous n'avions pas vu toutes les possi- 
bilites de cette bibliotheque. Elle peut lire aussi des CD, effectuer des enregistrements, 
des modifications sur le son, etc. Nous allons ici nous interesser a un de ses modules, 
appele DSP. 

A quoi servent les fonctions du module DSP ? Eh bien ce sont justement elles qui nous 
donnent des informations sur le son, afin que nous puissions realiser notre visualisation 
spectrale. 

II va falloir activer ce module 1 . Comme on n'en a pas toujours besoin, le module DSP 
est desactive par defaut. Heureusement, l'activer est tres simple : 

| FSOUND_DSP_SetActive(FSOUND_DSP_GetFFTUnit() , 1) ; 

Le premier parametre doit etre le resultat renvoye par FSOUND_DSP_GetFFTUnit (). 
Quant au second parametre, c'est un booleen : 

- si on envoie « vrai » (1), le module DSP est active; 

- si on envoie « faux » (0), le module DSP est desactive. 

Par consequent, si on veut desactiver le module DSP juste avant la fin du programme, 
il suffit d'ecrire : 

| FSOUWD_DSP_SetActive(FSOUWD_DSP_GetFFTUnit() , 0) ; 

3. Recuperer les donnees spectrales du son 

Pour comprendre le fonctionnement de la visualisation spectrale, il est indispensable 
que je vous explique un peu comment <ja fonctionne a l'interieur 2 . 

Un son peut etre decoupe en frequences (fig. 28.2). Certaines frequences sont basses, 
d'autres moyennes, et d'autres hautes. Ce que nous allons faire dans notre visualisation, 
c'est afficher la quantite de chacune de ces frequences sous forme de barres. Plus la barre 
est grande, plus la frequence est utilisee. 

Sur la gauche de la fenetre, nous faisons done apparaitre les basses frequences et sur la 
droite les hautes. 



1. Le module DSP n'est pas active par defaut car il demande pas mal de calculs supplement aires 
a l'ordinateur. 

2. Ce sera rapide je vous rassure, car je n'ai pas l'intention de transformer ce chapitre en cours de 
maths ! 
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Visualisation spectrale du 




Figure 28.2 - Decoupage des frequences 




Mais comment recuperer les quantities de chaque frequence? 



FMOD nous mache le travail. Maintenant que le module DSP est active, on peut faire 
appel a la fonction FSOUND_DSP_GetSpectrum() . II n'y a aucun parametre a lui donner. 
En revanche, elle vous renvoie quelque chose de tres interessant : un pointeur vers un 
tableau de 512 float. 




O 



Rappel : le type float est un type decimal, au meme titre que double. La 
difference entre les deux vient du fait que double est plus precis que float, 
mais dans notre cas le type float est suffisant. C'est celui utilise par FMOD 
ici, c'est done celui que nous devrons utiliser nous aussi. 



II vous faudra done declarer un pointeur vers float. FSOUND_DSP_GetSpectrum() vous 
renvoie le pointeur sur le tableau, done sur le premier element. 

En clair, on declare le pointeur : 

| float *spectre = NULL; 

Et lorsque la musique est en train d'etre jouee et que le module DSP est active, on 
peut recuperer l'adresse du tableau de 512 float que nous a cree FMOD : 



| spectre = FSOUWD_DSP_GetSpectrum() ; 
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On peut ensuite parcourir ce tableau pour obtenir les valeurs de chacune des frequences : 

spectre [0] // Frequence la plus basse (a gauche) 
spectre [1] 
spectre [2] 

spectre [509] 
spectre [510] 
spectre [511] // Frequence la plus haute (a droite) 

Chaque frequence est un nombre decimal compris entre (rien) et 1 (maximum) . Votre 
travail va consister a afficher une barre plus ou moins grande en fonction de la valeur 
que contient chaque case du tableau. 

Par exemple, si la valeur est 0.5, vous devrez tracer une barre dont la hauteur corres- 
pondra a la moitie de la fenetre. Si la valeur est 1, elle devra faire toute la hauteur de 
la fenetre. 

Generalement, les valeurs sont assez faibles (plutot proches de que de 1). Je recom- 
mande de multiplier par 4 toutes les valeurs pour mieux voir le spectre. Attention : si 
vous faites <ja, verifiez que vous ne depassez pas 1 (arrondissez a 1 s'il le faut). Si vous 
vous retrouvez avec des valeurs superieures a 1, vous risquez d'avoir des problemes 
pour tracer les barres verticales par la suite ! 

Mais les barres doivent bouger au fur et a mesure du temps, non ? Comme le 
son change tout le temps, il faut mettre a jour le graphique. Comment faire? 



Bonne question. En effet, le tableau de 512 float que vous renvoie FMOD change 
toutes les 25 ms (pour etre a jour par rapport au son actuel). II va done fal- 
loir dans votre code que vous relisiez le tableau de 512 float en refaisant appel a 
FSOUND_DSP_GetSpectrum() toutes les 25 ms 3 , puis que vous mettiez a jour votre 
graphique en barres. 



4. Realiser le degrade 

Dans un premier temps, vous pouvez realiser des barres de couleur unie. Vous pourrez 
done creer des surfaces. II devra y en avoir 512 : une pour chaque barre. Chaque surface 
fera done 1 pixel de large et la hauteur des surfaces variera en fonction de l'intensite 
de chaque frequence. 

Toutefois, je vous propose ensuite d'effectuer une amelioration : la barre doit fondre 
vers le rouge lorsque le son devient de plus en plus intense. En clair, la barre doit etre 
verte en bas et rouge en haut. 




3. Relisez le chapitre sur la gestion du temps en SDL pour vous rappeler comment faire. Vous avez 
le choix entre une solution a base de GetTicks ou a base de callbacks. Faites ce qui vous parait le plus 
facile. 
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Mais. . . une surface ne peut avoir qu'une seule couleur si on utili 
SDL_FillRect(). On ne peut pas faire de degrade! 



En effet. On pourrait certes creer des surfaces de 1 pixel de large et de haut pour 
chaque couleur du degrade, mais ga ferait vraiment beaucoup de surfaces a gerer et ga 
ne serait pas tres optimise ! 

Comment fait-on pour dessiner pixel par pixel ? Je ne vous l'ai pas appris auparavant 
car cette technique ne meritait pas un chapitre entier. Vous allez voir en effet que ce 
n'est pas bien complique. 

En fait, la SDL ne propose aucune fonction pour dessiner pixel par pixel. Mais on a le 
droit de l'ecrire nous-memes. 

Pour ce faire, il faut suivre ces etapes methodiquement dans l'ordre. 

1. Faites appel a la fonction SDL_LockSurf ace pour annoncer a la SDL que vous 
allez modifier la surface manuellement. Cela « bloque » la surface pour la SDL 
et vous etes le seul a y avoir acces tant que la surface est bloquee. Ici, je vous 
conseille de ne travailler qu'avec une seule surface : l'ecran. Si vous voulez dessiner 
un pixel a un endroit precis de l'ecran, vous devrez done bloquer la surface ecran : 

I SDL_LockSurf ace (ecran) ; 

2. Vous pouvez ensuite modifier le contenu de chaque pixel de la surface. Comme 
la SDL ne propose aucune fonction pour faire ca, il va falloir l'ecrire nous-memes 
dans notre programme. Cette fonction, je vous la donne. Je la tire de la docu- 
mentation de la SDL. Elle est un peu compliquee car elle travaille sur la surface 
directement et gere toutes les profondeurs de couleurs (bits par pixel) possibles. 
Pas besoin de la retenir ou de la comprendre, copiez-la simplement dans votre 
programme pour pouvoir l'utiliser : 

void setPixel(SDL_Surf ace ^surface, int x, int y, Uint32 pixel) 
{ 

int bpp = surf ace->f ormat->BytesPerPixel; 

Uint8 *p = (Uint8 *)surf ace->pixels + y * surface ->pitch + x * bpp; 

switch (bpp) { 
case 1 : 

*p = pixel; 

break ; 

case 2: 

*(Uintl6 *)p = pixel; 
break ; 

case 3: 

if (SDL_BYTEORDER == SDL_BIG_ENDIAN) { 
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p[0] 


= (pixel » 16) ft Oxff; 


p[l] 


= (pixel » 8) ft Oxff; 


p[2] 


= pixel ft Oxff; 


} else { 




p[0] 


= pixel ft Oxff; 


p[l] 


= (pixel » 8) ft Oxff; 


p[2] 


= (pixel » 16) ft Oxff; 


} 




break; 




case 4: 




*(Uint32 


*)p = pixel; 


break; 




} 




} 




> [ Code web : 310734 ] 



Elle est simple a utiliser. Envoyez les parametres suivants : 

- le pointeur vers la surface a modifier (cette surface doit prealablement avoir 
ete bloquee avec SDL_LockSurf ace) ; 

- la position en abscisse du pixel a modifier dans la surface (x) ; 

- la position en ordonnee du pixel a modifier dans la surface (y) ; 

- la nouvelle couleur a donner a ce pixel. Cette couleur doit etre au format 
Uint32, vous pouvez done la generer a l'aide de la fonction SDL_MapRGB() que 
vous connaissez bien maintenant. 

3. Enfin, lorsque vous avez fini de travailler sur la surface, il ne faut pas oublier de 
la debloquer en appelant SDL_UnlockSurf ace. 

SDL_UnlockSurface(ecran) ; 



Code resume d'exemple 

Si on resume, vous allez voir que e'est tout simple. Ce code dessine un pixel rouge au 
milieu de la surface ecran (done au milieu de la fenetre). 



SDL_LockSurf ace(ecran) ; /* On bloque la surface */ 

/* On dessine un pixel rouge au milieu de 1' ecran */ 

setPixel (ecran, ecran->w / 2, ecran->h / 2, SDL_MapRGB(ecran->f ormat , 255, 0, 0) ) ; 

SDL_UnlockSurf ace (ecran) ; /* On debloque la surface*/ 



Avec cette base vous devriez pouvoir realiser des degrades du vert au rouge ' 



4. Un indice : il faut utiliser des boucles. :-p 
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La solution 

Alors, comment vous avez trouve le sujet ? II n'est pas bien difficile a apprehender, il 
faut juste faire quelques calculs, surtout pour la realisation du degrade. C'est du niveau 
de tout le monde, il faut juste reflechir un petit peu. 

Certains mettent plus de temps que d'autres pour trouver la solution. Si vous avez du 
mal, ce n'est pas bien grave. Ce qui compte c'est de finir par y arriver. Quel que soit 
le projet dans lequel vous vous lancerez, vous aurez forcement des petits moments ou 
il ne suffit pas de savoir programmer, il faut aussi etre logique et bien reflechir. 

Le code 

Je vous donne le code complet ci-dessous. Nous le commenterons ensuite. 

#include <stdlib.h> 
#include <stdio.h> 
#include <SDL/SDL.h> 
#include <FM0D/fmod.h> 

#define LARGEUR_FENETRE 512 

#define HAUTEUR_FENETRE 400 

#define RATIO (HAUTEUR_FENETRE / 255.0) 

#define DELAI_RAFRAICHISSEMENT 25 

void setPixel(SDL_Surface ^surface, int x, int y, Uint32 pixel); 

int main(int argc, char *argv[]) 
{ 

SDL_Surface *ecran = NULL; 

SDL_Event event ; 

int continuer = 1, hauteurBarre = 0, temps Actuel = 0, tempsPrecedent = 0, 
^ i = 0, j = 0; 

float *spectre = NULL; 

/* Initialisation de FM0D 
*/ 

FS0UND_Init (44100, 4, 0); 

FS0UND_STREAM* musique = FS0UND_Stream_0pen("Hype_Home.mp3" , 0, 0, 0); 

if (musique == NULL) 

{ 

fprintf (stderr, "Impossible d'ouvrir la musique"); 

exit(EXIT_FAILURE) ; 
} 

FS0UND_DSP_SetActive(FS0UND_DSP_GetFFTUnit() , 1) ; 
FS0UND_Stream_Play(FS0UND_FREE, musique) ; 

/* Initialisation de la SDL 
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*/ 

SDL_Init(SDL_INIT_VIDEO) ; 

ecran = SDL_SetVideoMode(LARGEUR_FENETRE, HAUTEUR_FENETRE, 32, SDL_SWSURFACE 

^ I SDL_DOUBLEBUF) ; 

SDL_WM_SetCaption("Visualisation spectrale du son", NULL); 



/* Boucle principale */ 

while (continuer) 
{ 

SDL_PollEvent(&event) ; 
switch(event .type) 
{ 

case SDL_QUIT: 

continuer = 0; 
break; 
} 



SDL_FillRect (ecran, NULL, SDL_MapRGB(ecran->f ormat , 0, 0, 0)); 

/* Gestion du temps 

*/ 



tempsActuel = SDL_Get Ticks () ; 

if (tempsActuel - tempsPrecedent < DELAI_RAFRAICHISSEMENT) 

{ 

SDL_Delay(DELAI_RAFRAICHISSEMENT - (tempsActuel - tempsPrecedent)); 
} 
tempsPrecedent = SDL_GetTicks () ; 

/* Dessin du spectre sonore 
*/ 

spectre = FSOUND_DSP_GetSpectrum() ; 

SDL_LockSurf ace (ecran) ; 

for (i = ; i < LARGEUR_FENETRE ; i++) 
{ 

hauteurBarre = spectre [i] * 4 * HAUTEUR_FENETRE; 

if (hauteurBarre > HAUTEUR_FENETRE) 
hauteurBarre = HAUTEUR_FENETRE; 



for (j = HAUTEUR_FENETRE - hauteurBarre ; j < HAUTEUR_FENETRE ; j++) 
{ 

setPixel (ecran, i, j, SDL_MapRGB (ecran- >f ormat , 255 - (j / 
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^ RATIO) , j / RATIO, 0)); 

} 
} 

SDL_UnlockSurface(ecran) ; 

SDL_Flip(ecran) ; 
} 

FSOUND_DSP_SetActive(FSOUND_DSP_GetFFTUnit() , 0) ; 
FSOUND_Stream_Close(musique) ; 
FSOUND_Close() ; 

SDL_Quit() ; 

return EXIT_SUCCESS; 



void setPixel(SDL_Surface ^surface, int x, int y, Uint32 pixel) 
{ 

int bpp = surf ace->f ormat->BytesPerPixel; 

Uint8 *p = (Uint8 *) surf ace->pixels + y * surface->pitch + x * bpp; 

switch (bpp) { 
case 1 : 

*p = pixel; 

break; 

case 2 : 

*(Uintl6 *)p = pixel; 
break; 

case 3 : 

if (SDL_BYTEORDER == SDL_BIG_ENDIAN) { 

p[0] = (pixel » 16) ft Oxff; 

p[l] = (pixel » 8) ft Oxff; 

p[2] = pixel ft Oxff; 
} else { 

p[0] = pixel ft Oxff; 

p[l] = (pixel » 8) ft Oxff; 

p[2] = (pixel » 16) ft Oxff; 
} 
break; 

case 4: 

*(Uint32 *)p = pixel; 

break; 
} 
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Vous pouvez recuperer ce code dans une version largement commentee si vous le desirez. 
> ( Code web : 892216) 



Explication du code 

Dans un premier temps, on initialise FMOD, la musique et le module DSP. On charge 
ensuite la SDL. 

Dans ma boucle principale, j'ai choisi de gerer le temps via SDL_GetTicks (je n'ai pas 
fait de callback). Je verifie a chaque tour de boucle qu'au moins 25 ms se sont ecoulees. 
Si ce n'est pas le cas, on attend le temps qu'il faut avec SDL_Delay pour atteindre les 
25 ms. 

On peut ensuite dessiner le spectre sonore. On recupere le tableau de 512 float et 
on travaille ensuite pixel par pixel sur la surface ecran pour y dessiner les barres avec 
deux boucles : la premiere pour parcourir la fenetre en largeur et la seconde pour la 
parcourir en hauteur et y dessiner chaque barre. 

Comme je vous l'avais dit, j'ai multiplies par 4 la valeur du spectre pour « zoomer » 
un peu. Bien entendu, on risque alors de depasser la hauteur de la fenetre : je tronque 
done la barre verticale si on depasse HAUTEUR_FENETRE. 

Ensuite, il ne reste plus qu'a parcourir en hauteur la fenetre pour dessiner la barre. 
II faut faire quelques legers calculs pour adapter proportionnellement la barre a la 
hauteur de la fenetre. 



Telecharger et visualiser le resultat 

Vous devriez obtenir un resultat correspondant a la capture d'ecran que je vous avais 
montree au debut du chapitre. Bien entendu, il vaut mieux une animation pour appre- 
cier ce resultat. C'est done ce que je vous propose de visualiser. 



c> 



Code web : 205404 



Notez que la compression a reduit la qualite du son et le nombre d'images par seconde. 
Le mieux est encore de telecharger le programme complet (avec son code source) pour 
tester chez soi. Vous pourrez ainsi apprecier le programme dans les meilleures condi- 
tions. 



> [ Code web : 817059 ) 



© 



II faut imperativement que le fichier Hype_Home . mp3 soit place dans le dossier 
du programme pour que celui-ci fonctionne (sinon il s'arretera de suite). 
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Idees d'amelioration 

II est toujours possible d'ameliorer un programme. Ici, j'ai de nombreuses idees d'ex- 
tensions qui pourraient aboutir a la creation d'un veritable petit lecteur MP3. 

- II serait bien qu'on puisse choisir le MP3 qu'on veut lire. II faudrait par exemple 
lister tous les .mp3 presents dans le dossier du programme. On n'a pas vu comment 
faire §a, mais vous pouvez le decouvrir par vous-memes 5 . 

- Si votre programme etait capable de lire et gerer les playlists, <ja serait encore mieux. 
II existe plusieurs formats de playlist, le plus connu est le format M3U. 

- Vous pourriez afficher le nom du MP3 en cours de lecture dans la fenetre (il faudra 
utiliser SDL_ttf). 

- Vous pourriez afficher un indicateur pour qu'on sache ou en est de la lecture du 
morceau, comme cela se fait sur la plupart des lecteurs MP3. 

- Vous pourriez aussi proposer de modifier le volume de lecture. 

- etc. 

Bref, il y a beaucoup a faire. Vous avez la possibilite de creer de beaux lecteurs audio, 
il ne tient plus qu'a vous de les coder! 



5. Indice : utilisez la bibliotheque dirent (il faudra inclure dirent.h). A vous de chercher des 
informations sur le web pour savoir comment Futiliser. 
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Chapitre 



29 



Les listes chaTnees 



Difficulty : HB 

Pour stocker des donnees en memoire, nous avons utilise des variables simples (type 
int, double. . .), des tableaux et des structures personnalisees. Si vous souhaitez 
stocker une serie de donnees, le plus simple est en general d'utiliser des tableaux. 

Toutefois, les tableaux se revelent parfois assez limites. Par exemple, si vous creez un 
tableau de 10 cases et que vous vous rendez compte plus tard dans votre programme que 
vous avez besoin de plus d'espace, il sera impossible d'agrandir ce tableau. De meme, il 
n'est pas possible d'inserer une case au milieu du tableau. 

Les listes chaTnees representent une facon d'organiser les donnees en memoire de maniere 
beaucoup plus flexible. Comme a la base le langage C ne propose pas ce systeme de stockage, 
nous allons devoir le creer nous-memes de toutes pieces. C'est un excellent exercice qui vous 
aidera a etre plus a I'aise avec le langage. 
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Representation d'une liste chainee 



Qu'est-ce qu'une liste chainee? Je vous propose de partir sur le modele des tableaux. 
Un tableau peut etre represents 1 en memoire comme sur la fig. 29.1. II s'agit ici d'un 
tableau contenant des int. 



Figure 29.1 - Un tableau de 4 cases en memoire (representation horizontale) 



Comme je vous le disais en introduction, le probleme des tableaux est qu'ils sont figes. 
II n'est pas possible de les agrandir, a moins d'en creer de nouveaux, plus grands (fig. 
29.2). De meme, il n'est pas possible d'y inserer une case au milieu, a moins de decaler 
tous les autres elements. 




Impossible d'ajouterdes 

cases a un tableau apres 

sa creation ! 



Figure 29.2 - On ne peut pas agrandir un tableau apres sa creation 



Le langage C ne propose pas d'autre systeme de stockage de donnees, mais il est possible 
de le creer soi-meme de toutes pieces. Encore faut-il savoir comment s'y prendre : c'est 
justement ce que ce chapitre et les suivants vous proposent de decouvrir. 

Une liste chainee est un moyen d'organiser une serie de donnees en memoire. Cela 
consiste a assembler des structures en les liant entre elles a l'aide de pointeurs. On 
pourrait les representer comme ceci : 



Figure 29.3 - Une liste chainee est un assemblage de structures liees par des pointeurs 

Chaque element peut contenir ce que l'on veut : un ou plusieurs int, double. . . En 
plus de cela, chaque element possede un pointeur vers l'element suivant (fig. 29.4). 

Je reconnais que tout cela est encore tres theorique et doit vous paraitre un peu flou 
pour le moment. Retenez simplement comment les elements sont agences entre eux : 
ils forment une chaine de pointeurs, d'ou le nom de « liste chainee ». 



Contrairement aux tableaux, les elements d'une liste chamee ne sont pas 
places cote a cote dans la memoire. Chaque case pointe vers une autre case 
en memoire qui n'est pas necessairement stockee juste a cote. 




a 



1. J'ai choisi ici de representer le tableau horizontalement, mais il serait aussi possible de le presenter 
verticalement, peu importe. 
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» 



Donnees 
(ex. : int) 



Pointeur 



Figure 29.4 - Chaque element contient une donnee (ex. : un int) et un pointeur vers 
l'element suivant 



Construction d'une liste chainee 

Passons maintenant au concret. Nous allons essayer de creer une structure qui fonc- 
tionne sur le principe que nous venons de decouvrir 2 . 

Un element de la liste 

Pour nos exemples, nous allons creer une liste chainee de nombres entiers 3 . Chaque 
element de la liste aura la forme de la structure suivante : 



typedef struct Element Element; 

struct Element 

{ 

int nombre ; 

Element *suivant; 

}; 



Nous avons cree ici un element d'une liste chainee, correspondant a la fig. 29.4 que 
nous avons vue plus tot. Que contient cette structure? 

- Une donnee, ici un nombre de type int : on pourrait remplacer cela par n'importe 
quelle autre donnee (un double, un tableau. . .). Cela correspond a ce que vous voulez 
stocker, c'est a vous de l'adapter en fonction des besoins de votre programme 4 . 

- Un pointeur vers un element du meme type appele suivant. C'est ce qui permet de 
lier les elements les uns aux autres : chaque element « sait » ou se trouve l'element 



2. Je rappelle que tout ce que nous allons faire ici fait appel a des techniques du langage C que 
vous connaissez deja. II n'y a aucun element nouveau, nous allons nous contenter de creer nos propres 
structures et fonctions et les transformer en un systeme logique, capable de se reguler tout seul. 

3. On pourrait aussi bien creer une liste chainee contenant des nombres decimaux ou meme des 
tableaux et des structures. Le principe des listes chainees s'adapte a n'importe quel type de donnees, 
mais ici, je propose de faire simple pour que vous compreniez bien le principe. ;-) 

4. Si on veut travailler de maniere generique, l'ideal est de faire un pointeur sur void : void*. Cela 
permet de faire pointer vers n'importe quel type de donnees. 
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suivant en memoire 5 . Comme je vous le disais plus tot, les cases ne sont pas cote 
a cote en memoire. C'est la grosse difference par rapport aux tableaux. Cela offre 
davantage de souplesse car on peut plus facilement ajouter de nouvelles cases par la 
suite au besoin. 



La structure de controle 

En plus de la structure qu'on vient de creer (que l'on dupliquera autant de fois qu'il y 
a d'elements), nous allons avoir besoin d'une autre structure pour controler l'ensemble 
de la liste chainee. Elle aura la forme suivante : 

typedef struct Liste Liste; 

struct Liste 

{ 

Element ^premier; 

}; 

Cette structure Liste contient un pointeur vers le premier element de la liste. En effet, 
il faut conserver l'adresse du premier element pour savoir ou commence la liste. Si on 
connait le premier element, on peut retrouver tous les autres en « sautant » d'element 
en element a l'aide des pointeurs suivant. 

Une structure composee d'une seule sous-variable n'est en general pas tres 
utile. Neanmoins, je pense que l'on aura besoin d'y ajouter des sous-variables 
plus tard, je prefere done prendre les devants en creant ici une structure. 
On pourrait par exemple y stocker en plus la taille de la liste, e'est-a-dire le 
nombre d'elements qu'elle contient. 




a 



Nous n'aurons besoin de creer qu'un seul exemplaire de la structure Liste. Elle permet 
de controler toute la liste (fig. 29.5). 

Le dernier element de la liste 

Notre schema est presque complet. II manque une derniere chose : on aimerait retenir 
le dernier element de la liste. En effet, il faudra bien arreter de parcourir la liste a un 
moment donne. Avec quoi pourrait-on signifier a notre programme « Stop, ceci est le 
dernier element » ? 

II serait possible d'ajouter dans la structure Liste un pointeur vers le dernier Element. 
Toutefois, il y a encore plus simple : il suffit de faire pointer le dernier element de la 
liste vers NULL, e'est-a-dire de mettre son pointeur suivant a NULL. Cela nous permet 
de realiser un schema enfin complet de notre structure de liste chainee (fig. 29.6). 



5. En revanche, il ne sait pas quel est l'element precedent, il est done impossible de revenir en 
arriere a partir d'un element avec ce type de liste. On parle de liste « simplement chainee », alors que 
les listes « doublement chainees » ont des pointeurs dans les deux sens et n'ont pas ce defaut. Elles 
sont neanmoins plus complexes. 
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Figure 29.5 - La structure Liste nous donne des informations sur l'ensemble de la 
liste chainee 




NULL 



Figure 29.6 - Le dernier element de la liste pointe vers NULL pour indiquer la fin de 
liste 
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Les fonctions de gestion de la liste 

Nous avons cree deux structures qui permettent de gerer une liste chainee : 

- Element, qui correspond a un element de la liste et que l'on peut dupliquer autant 
de fois que necessaire ; 

- Liste, qui controle l'ensemble de la liste. Nous n'en aurons besoin qu'en un seul 
exemplaire. 

C'est bien, mais il manque encore l'essentiel : les fonctions qui vont manipuler la liste 
chainee. En effet, on ne va pas modifier « a la main » le contenu des structures a chaque 
fois qu'on en a besoin ! II est plus sage et plus propre de passer par des fonctions qui 
automatisent le travail. Encore faut-il les creer. 

A premiere vue, je dirais qu'on aura besoin de fonctions pour : 

- initialiser la liste ; 

- aj outer un element ; 

- supprimer un element ; 

- afficher le contenu de la liste ; 

- supprimer la liste entiere. 

On pourrait creer d'autres fonctions (par exemple pour calculer la taille de la liste) 
mais elles sont moins indispensables. Nous allons ici nous concentrer sur celles que je 
viens de vous enumerer, ce qui nous fera deja une bonne base. Je vous inviterai ensuite 
a realiser d'autres fonctions pour vous entrainer une fois que vous aurez bien compris 
le principe. 

Initialiser la liste 

La fonction d'initialisation est la toute premiere que l'on doit appeler. Elle cree la 
structure de controle et le premier element de la liste. 

Je vous propose la fonction ci-dessous, que nous commenterons juste apres, bien en- 
tendu : 



Liste *initialisation() 
{ 

Liste *liste = malloc(sizeof (*liste) ) ; 

Element *element = malloc(sizeof (*element) ) ; 

if (liste == NULL I I element == NULL) 
{ 

exit(EXIT_FAILURE) ; 
} 

element ->nombre = 0; 
element ->suivant = NULL; 
liste->premier = element; 
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return liste; 



On commence par creer la structure de controle liste 6 . On l'alloue dynamiquement 
avec un malloc. La taille a allouer est calculee automatiquement avec sizeof (*liste) . 
L'ordinateur saura qu'il doit allouer l'espace necessaire au stockage de la structure 
Liste 7 . 

On alloue ensuite de la meme maniere la memoire necessaire au stockage du premier 
element. On verifie si les allocations dynamiques ont fonctionne. En cas d'erreur, on 
arrete immediatement le programme en faisant appel a exit(). 

Si tout s'est bien passe, on definit les valeurs de notre premier element : 

- la donnee nombre est mise a par defaut ; 

- le pointeur suivant pointe vers NULL car le premier element de notre liste est aussi 
le dernier pour le moment. Comme on l'a vu plus tot, le dernier element doit pointer 
vers NULL pour signaler qu'il est en fin de liste. 

Nous avons done maintenant reussi a creer en memoire une liste composee d'un seul 
element et ayant une forme semblable a la fig. 29.7. 



n 












i 


L 




premier 





NULL 



Figure 29.7 - L'etat de la liste qui vient d'etre initialisee 



Ajouter un element 

Ici, les choses se compliquent un peu. Ou va-t-on ajouter un nouvel element ? Au debut 
de la liste, a la fin, au milieu ? 

La reponse est qu'on a le choix. Libre a nous de decider ce que nous faisons. Pour 
ce chapitre, je propose que l'on voie ensemble l'ajout d'un element en debut de liste. 
D'une part, e'est simple a comprendre, et d'autre part cela me donnera une occasion 
a la fin de ce chapitre de vous proposer de reflechir a la creation d'une fonction qui 
ajoute un element a un endroit precis de la liste. 

Nous devons creer une fonction capable d'inserer un nouvel element en debut de liste. 



6. Notez que le type de donnees est Liste et que la variable s'appelle liste. La majuscule permet 
de les differencier. 

7. On aurait aussi pu ecrire sizeof (Liste), mais si plus tard on decide de modifier le type du 
pointeur liste, on devra aussi adapter le sizeof. 
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Pour nous mettre en situation, imaginons un cas semblable a la fig. 29.8 : la liste est 
composee de trois elements et on souhaite en ajouter un nouveau au debut. 



•NULL 



premier 



Figure 29.8 - On souhaite inserer notre nouvel element en debut de liste 

II va falloir adapter le pointeur premier de la liste ainsi que le pointeur suivant de 
notre nouvel element pour « inserer » correctement celui-ci dans la liste. Je vous propose 
pour cela ce code source que nous analyserons juste apres : 

void insertion(Liste *liste, int nvNombre) 
{ 

/* Creation du nouvel element */ 

Element *nouveau = malloc(sizeof (*nouveau) ) ; 

if (liste == NULL I I nouveau == NULL) 

{ 

exit(EXIT_FAILURE) ; 

} 

nouveau->nombre = nvNombre; 

/* Insertion de 1 'element au debut de la liste */ 
nouveau->suivant = liste->premier; 
liste->premier = nouveau; 



La fonction insertionO prend en parametre l'element de controle liste (qui contient 
l'adresse du premier element) et le nombre a stocker dans le nouvel element que l'on 
va creer. 

Dans un premier temps, on alloue l'espace necessaire au stockage du nouvel element et 
on y place le nouveau nombre nvNombre. II reste alors une etape delicate : l'insertion 
du nouvel element dans la liste chainee. 

Nous avons ici choisi pour simplifier d'inserer l'element en debut de liste. Pour mettre 
a jour correctement les pointeurs, nous devons proceder dans cet ordre precis : 

1. faire pointer notre nouvel element vers son futur successeur, qui est l'actuel pre- 
mier element de la liste ; 
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2. faire pointer le pointeur premier vers notre nouvel element. 



A 



On ne peut pas suivre ces etapes dans I'ordre inverse ! En effet, si vous faites 
d'abord pointer premier vers notre nouvel element, vous perdez I'adresse du 
premier element de la liste I Faites le test, vous comprendrez de suite pourquoi 
I'inverse est impossible. 



Cela aura pour effet d'inserer correctement notre nouvel element dans la liste chainee 
(fig. 29.9) ! 




NULL 



Figure 29.9 - Insertion d'un element dans la liste chainee 



Supprimer un element 

De meme que pour l'insertion, nous allons ici nous concentrer sur la suppression du 
premier element de la liste. II est techniquement possible de supprimer un element 
precis au milieu de la liste, ce sera d'ailleurs un des exercices que je vous proposerai a 
la fin. 

La suppression ne pose pas de difficulte supplementaire. II faut cependant bien adapter 
les pointeurs de la liste dans le bon ordre pour ne « perdre » aucune information. 



void suppression(Liste *liste) 
{ 

if (liste == NULL) 

{ 

exit (EXIT_FAILURE) ; 

} 

if (liste->premier != NULL) 
{ 

Element *aSupprimer = liste->premier ; 

liste->premier = liste->premier->suivant ; 

f ree (aSupprimer) ; 
} 
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On commence par verifier que le pointeur qu'on nous envoie n'est pas NULL, sinon on 
ne peut pas travailler. On verifie ensuite qu'il y a au moins un element dans la liste, 
sinon il n'y a rien a faire. 

Ces verifications effectuees, on peut sauvegarder l'adresse de l'element a supprimer 
dans un pointeur aSupprimer. On adapte ensuite le pointeur premier vers le nouveau 
premier element, qui est actuellement en seconde position de la liste chainee. 

II ne reste plus qu'a supprimer l'element correspondant a notre pointeur aSupprimer 
avec un free (fig. 29.10). 



aSupprimer 




»-NULL 



Figure 29.10 - Suppression d'un element de la liste chainee 

Cette fonction est courte mais sauriez-vous la reecrire ? II faut bien comprendre qu'on 
doit faire les choses dans un ordre precis : 

1. faire pointer premier vers le second element ; 

2. supprimer le premier element avec un free. 

Si on faisait l'inverse, on perdrait l'adresse du second element ! 



Afflcher la liste chainee 

Pour bien visualiser ce que contient notre liste chainee, une fonction d'affichage serait 
ideale ! II suffit de partir du premier element et d'afficher chaque element un a un en 
« sautant » de bloc en bloc. 



void aff icherListe (Liste *liste) 
{ 

if (liste == NULL) 

{ 

exit(EXIT_FAILURE) ; 

} 

Element *actuel = liste->premier ; 

while (actuel != NULL) 
{ 
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printf ("'/,d -> ", actuel->nombre) ; 

actuel = actuel->suivant ; 
} 

printf ("NULlAn"); 
} 

Cette fonction est simple : on part du premier element et on affiche le contenu de 
chaque element de la liste (un nombre). On se sert du pointeur suivant pour passer a 
l'element qui suit a chaque fois. 

On peut s'amuser a tester la creation de notre liste chainee et son affichage avec un 
main : 

int main ( ) 
{ 

Liste *maListe = initialisationO ; 

insertion(maListe, 4); 
insertion(maListe, 8); 
insertion(maListe, 15); 
suppression(maListe) ; 

af f icherListe(maListe) ; 

return ; 



En plus du premier element (que l'on a laisse ici a 0), on en ajoute trois nouveaux a 
cette liste. Puis on en supprime un. Au final, le contenu de la liste chainee sera done : 

_> 4 _> -> NULL ~~ k 



Aller plus loin 

Nous venons de faire le tour des principales fonctions necessaires a la gestion d'une 
liste chainee : initialisation, ajout d'element, suppression d'element, etc. Voici quelques 
autres fonctions qui manquent et que je vous invite a ecrire, ce sera un tres bon exercice ! 

Insertion d'un element en milieu de liste : actuellement, nous ne pouvons 
ajouter des elements qu'au debut de la liste, ce qui est generalement suffisant. Si 
toutefois on veut pouvoir ajouter un element au milieu, il faut creer une fonction 
specifique qui prend un parametre supplementaire : l'adresse de celui qui precedera 
notre nouvel element dans la liste. Votre fonction va parcourir la liste chainee jusqu'a 
tomber sur l'element indique. Elle y inserera le petit nouveau juste apres. 
Suppression d'un element en milieu de liste : le principe est le meme que pour 
l'insertion en milieu de liste. Cette fois, vous devez ajouter en parametre l'adresse 
de l'element a supprimer. 
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- Destruction de la liste : il suffit de supprimer tous les elements unaun! 

- Taille de la liste : cette fonction indique combien il y a d'elements dans votre liste 
chainee. L'ideal, plutot que d'avoir a calculer cette valeur a chaque fois, serait de 
maintenir a jour un entier nbElements dans la structure Liste. II suffit d'incrementer 
ce nombre a chaque fois qu'on ajoute un element et de le decrementer quand on en 
supprime un. 

Je vous conseille de regrouper toutes les fonctions de gestion de la liste chainee dans 
des fichiers liste_chainee . c et liste_chainee .h par exemple. Ce sera votre premiere 
bibliotheque ! Vous pourrez la reutiliser dans tous les programmes dans lesquels vous 
avez besoin de listes chainees. 

Vous pouvez telecharger le projet des listes chainees comprenant les fonctions que nous 
avons decouvertes ensemble. Cela vous fera une bonne base de depart. 



t> ( Code web : 603716 ) 



En resume 

- Les listes chainees constituent un nouveau moyen de stocker des donnees en memoire. 
Elles sont plus flexibles que les tableaux car on peut ajouter et supprimer des « cases » 
a n'importe quel moment. 

- II n'existe pas en langage C de systeme de gestion de listes chainees, il faut l'ecrire 
nous-memes ! C'est un excellent moyen de progresser en algorithmique et en pro- 
grammation en general. 

- Dans une liste chainee, chaque element est une structure qui contient l'adresse de 
l'element suivant. 

- II est conseille de creer une structure de controle (du type Liste dans notre cas) qui 
retient l'adresse du premier element. 

- II existe une version amelioree — mais plus complexe — des listes chainees appe- 
lee « listes doublement chainees », dans lesquelles chaque element possede en plus 
l'adresse de celui qui le precede. 
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30 



Les piles et les files 



Difficulty : WB 

ous avons decouvert avec les listes chatnees un nouveau moyen plus souple que les 
tableaux pour stocker des donnees. Ces listes sont particulierement flexibles car on 
peut inserer et supprimer des donnees a n'importe quel endroit, a n'importe quel 
moment. 

Les piles et les files que nous allons decouvrir ici sont deux variantes un peu particulieres 
des listes chamees. Elles permettent de controler la maniere dont sont ajoutes les nouveaux 
elements. Cette fois, on ne va plus inserer de nouveaux elements au milieu de la liste mais 
seulement au debut ou a la fin. 

Les piles et les files sont tres utiles pour des programmes qui doivent traiter des donnees 
qui arrivent au fur et a mesure. Nous allons voir en details leur fonctionnement dans ce 
chapitre. 
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Les piles et les files sont tres similaires, mais revelent neanmoins une subtile difference 
que vous allez rapidement reconnaitre. Nous allons dans un premier temps decouvrir 
les piles qui vont d'ailleurs beaucoup vous rappeler les listes chainees, a quelques mots 
de vocabulaire pres. 

Globalement, ce chapitre sera simple pour vous si vous avez compris le fonctionnement 
des listes chainees. Si ce n'est pas le cas, retournez d'abord au chapitre precedent car 
nous allons en avoir besoin. 



Les piles 

Imaginez une pile de pieces (fig. 30.1). Vous pouvez ajouter des pieces une a une en haut 
de la pile, mais aussi en enlever depuis le haut de la pile. II est en revanche impossible 
d'enlever une piece depuis le bas de la pile 1 ! 




Figure 30.1 - Une pile de pieces 



Fonctionnement des piles 

Le principe des piles en programmation est de stocker des donnees au fur et a mesure les 
unes au-dessus des autres pour pouvoir les recuperer plus tard. Par exemple, imaginons 
une pile de nombres entiers de type int (fig. 30.2). Si j'ajoute un element (on parle 
d'empilage), il sera place au-dessus 2 (fig. 30.3). 

Le plus interessant est sans conteste l'operation qui consiste a extraire les nombres de 
la pile. On parle de depilage. On recupere les donnees une a une, en commengant 
par la derniere qui vient d'etre posee tout en haut de la pile (fig. 30.4). On enleve les 
donnees au fur et a mesure, jusqu'a la derniere tout en bas de la pile. 

On dit que c'est un algorithme LIFO, ce qui signifie « Last In First Out ». Traduction : 
« Le dernier element qui a ete ajoute est le premier a sortir ». 

Les elements de la pile sont relies entre eux a la maniere d'une liste chainee. lis possedent 
un pointeur vers l'element suivant et ne sont done pas forcement places cote a cote en 
memoire. Le dernier element (tout en bas de la pile) doit pointer vers NULL pour indiquer 
qu'on a. . . touche le fond (fig. 30.5). 



1. Si vous voulez essayer, bon courage ! 

2. Oui, comme dans Tetris. ;-) 
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Figure 30.2 - Une pile de int 



Empilage 
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Figure 30.3 - Empilage 
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Depilage 
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Figure 30.4 - Depilage 
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Figure 30.5 - Les elements sont relies entre eux et le dernier pointe vers NULL 
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A quoi est-ce que tout cela peut bien servir, concretement ? 



II y a des programmes oil vous avez besoin de stocker des donnees temporairement 
pour les ressortir dans un ordre precis : le dernier element que vous avez stocke doit 
etre le premier a ressortir. 

Pour vous donner un exemple concret, votre systeme d'exploitation utilise ce type 
d'algorithme pour retenir l'ordre dans lequel les fonctions ont ete appelees. Imaginez 
un exemple : 

1. votre programme commence par la fonction main (comme toujours) ; 

2. vous y appelez la fonction jouer ; 

3. cette fonction jouer fait appel a son tour a la fonction charger ; 

4. une fois que la fonction charger est terminee, on retourne a la fonction jouer ; 

5. une fois que la fonction jouer est terminee, on retourne au main; 

6. enfin, une fois le main termine, il n'y a plus de fonction a appeler, le programme 
s'acheve. 

Pour « retenir » l'ordre dans lequel les fonctions ont ete appelees, votre ordinateur cree 
une pile de ces fonctions au fur et a mesure (fig. 30.6). 



charger 



jouer 



jouer 



jouer 



main 



main 



main 



main 



main 



Empilage Depilage 

Figure 30.6 - La pile d'appel des fonctions au fur et a mesure du programme 

Voila un exemple concret d'utilisation des piles. Grace a cette technique, votre ordina- 
teur sait a quelle fonction il doit retourner. II peut empiler 100 fonctions d'affilee s'il 
le faut, il retrouvera toujours le main en bas ! 
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Creation d'un systeme de pile 

Maintenant que nous connaissons le principe de fonctionnement des piles, essayons d'en 
construire une. Comme pour les listes chainees, il n'existe pas de systeme de pile integre 
au langage C. II faut done le creer nous-memes. 

Chaque element de la pile aura une structure identique a celle d'une liste chainee : 

typedef struct Element Element; 

struct Element 

{ 

int nombre; 

Element *suivant; 

}; 

La structure de controle contiendra l'adresse du premier element de la pile, celui qui 
se trouve tout en haut : 

typedef struct Pile Pile; 

struct Pile 

{ 

Element *premier; 

}; 

Nous aurons besoin en tout et pour tout des fonctions suivantes : 

- empilage d'un element ; 

- depilage d'un element. 

Vous noterez que, contrairement aux listes chainees, on ne parle pas d'ajout ni de 
suppression. On parle d'empilage et de depilage car ces operations sont limitees a un 
element precis, comme on l'a vu. Ainsi, on ne peut ajouter et retirer un element qu'en 
haut de la pile. 

On pourra aussi ecrire une fonction d'affichage de la pile, pratique pour verifier si notre 
programme se comporte correctement. 

Allons-y ! 

Empilage 

Notre fonction empiler doit prendre en parametre la structure de controle de la pile 
(de type Pile) ainsi que le nouveau nombre a stocker 3 . 

void empiler (Pile *pile, int nvNombre) 
{ 



3. Je vous rappelle que nous stockons ici des int, mais rien ne vous empeche d'adapter ces exemples 
avec un autre type de donnees. On peut stocker n'importe quoi : des double, des char, des chaines, 
des tableaux ou meme d'autres structures ! 
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Element *nouveau = malloc(sizeof (*nouveau) ) ; 

if (pile == NULL I I nouveau == NULL) 

{ 

exit (EXIT_FAILURE) ; 
} 

nouveau- >nombre = nvNombre; 
nouveau- >suivant = pile->premier; 
pile->premier = nouveau; 



L'ajout se fait en debut de pile car, comme on l'a vu, il est impossible de le faire au 
milieu d'une pile. C'est le principe meme de son fonctionnement, on ajoute toujours 
par le haut 4 . 

Depilage 

Le rfile de la fonction de depilage est de supprimer l'element tout en haut de la pile, <ja, 
vous vous en doutiez. Mais elle doit aussi retourner l'element qu'elle depile, c'est-a-dire 
dans notre cas le nombre qui etait stocke en haut de la pile. 

C'est comme cela que l'on accede aux elements d'une pile : en les enlevant un a un. 
On ne parcourt pas la pile pour aller y chercher le second ou le troisieme element. On 
demande toujours a recuperer le premier. 

Notre fonction depiler va done retourner un int correspondant au nombre qui se 
trouvait en tete de pile : 

int depiler (Pile *pile) 
{ 

if (pile == NULL) 

{ 

exit (EXIT_FAILURE) ; 

} 

int nombreDepile = ; 

Element *elementDepile = pile->premier ; 

if (pile != NULL kk pile->premier != NULL) 
{ 

nombreDepile = elementDepile->nombre; 

pile->premier = elementDepile->suivant ; 

f ree(elementDepile) ; 
} 

return nombreDepile; 



4. De ce fait, contrairement aux listes chainees, on ne doit pas creer de fonction pour inserer un 
element au milieu de la pile. Seule la fonction empiler permet d'ajouter un element. 
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On recupere le nombre en tete de pile pour le renvoyer a la fin de la fonction. On 
modifie l'adresse du premier element de la pile, puisque celui-ci change. Enfin, bien 
entendu, on supprime l'ancienne tete de pile grace a free. 

AfHchage de la pile 

Bien que cette fonction ne soit pas indispensable 5 , elle va nous etre utile pour tester 
le fonctionnement de notre pile et surtout pour « visualiser » le resultat. 

void aff icherPile(Pile *pile) 
{ 

if (pile == NULL) 

{ 

exit(EXIT_FAILURE) ; 

} 

Element *actuel = pile->premier; 

while (actuel != NULL) 
{ 

printf ("*/,d\n" , actuel->nombre) ; 

actuel = actuel->suivant ; 
} 

printf ("\n") ; 



Cette fonction etant ridiculement simple, elle ne necessite aucune explication 6 . 

En revanche, c'est le moment de faire un main pour tester le comportement de notre 
pile : 

int main() 
{ 

Pile *maPile = initialiserO ; 

empiler (maPile, 4); 

empiler (maPile, 8); 

empiler (maPile, 15) 

empiler (maPile, 16) 

empiler (maPile, 23) 

empiler (maPile, 42) 

printf ("\nEtat de la pile :\n"); 
aff icherPile (maPile) ; 

printf ("Je depile */,d\n", depiler (maPile) ) ; 



5. Les fonctions empiler et depiler suffisent a gerer une pile ! 

6. Et toe ! 
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printf("Je depile */,d\n" , depiler(maPile) ) ; 

printf ("\nEtat de la pile :\n"); 
af f icherPile(maPile) ; 

return ; 



} 



On affiche l'etat de la pile apres plusieurs empilages et une autre fois apres quelques 
depilages. On affiche aussi le nombre qui est depile a chaque fois que l'on depile. Le 
resultat dans la console est le suivant : 



Etat de la pile : 
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Verifiez que vous voyez bien ce qui se passe dans ce programme. Si vous comprenez 
cela, vous avez compris le fonctionnement des piles ! 

Vous pouvez telecharger le projet complet des piles si vous le desirez. 

> ( Code web : 935065 ) 

Les files 

Les files ressemblent assez aux piles, si ce n'est qu'elles fonctionnent dans le sens inverse ! 

Fonctionnement des files 

Dans ce systeme, les elements s'entassent les uns a la suite des autres. Le premier qu'on 
fait sortir de la file est le premier a etre arrive. On parle ici d'algorithme FIFO (First 
In First Out), c'est-a-dire « Le premier qui arrive est le premier a sortir ». 

II est facile de faire le parallele avec la vie courante. Quand vous allez prendre un 
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billet de cinema, vous faites la queue au guichet (fig. 30.7). A moms d'etre le frere du 
guichetier, vous allez devoir faire la queue comme tout le monde et attendre derriere. 
C'est le premier arrive qui sera le premier servi. 




Figure 30.7 - Une file d'attente. Le premier arrive est le premier servi ! 

En programmation, les files sont utiles pour mettre en attente des informations dans 
l'ordre dans lequel elles sont arrivees. Par exemple, dans un logiciel de chat (type 
messagerie instantanee) , si vous recevez trois messages a peu de temps d'intervalle, 
vous les enfilez les uns a la suite des autres en memoire. Vous vous occupez alors du 
premier message arrive pour l'afficher a l'ecran, puis vous passez au second, et ainsi de 
suite. 

Les evenements que vous envoie la bibliotheque SDL que nous avons etudiee sont eux 
aussi stockes dans une file. Si vous bougez la souris, un evenement sera genere pour 
chaque pixel dont s'est deplace le curseur de la souris. La SDL les stocke dans une file 
puis vous les envoie un a un a chaque fois que vous faites appel a SDL_PollEvent 7 . 

En C, une file est une liste chainee ou chaque element pointe vers le suivant, tout 
comme les piles. Le dernier element de la file pointe vers NULL (fig. 30.8). 



NULL 



Dernier 
de la file 



Premier 
de la file 



Figure 30.8 - Representation d'une file 



Creation d'un systeme de file 

Le systeme de file va ressembler a peu de choses pres aux piles. II y a seulement quelques 
petites subtilites etant donne que les elements sortent de la file dans un autre sens, mais 



7. Ou a SDL_WaitEvent : oui, c'est bien ! Je vois que ga suit au fond de la classe. ;-) 
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rien d'insurmontable si vous avez compris les piles. 

Nous allons creer une structure Element et une structure de controle File : 

typedef struct Element Element; 

struct Element 

{ 

int nombre ; 

Element *suivant; 

}; 

typedef struct File File; 

struct File 

{ 

File ^premier; 

}; 

Comme pour les piles, chaque element de la file sera de type Element. A l'aide du 
pointeur premier, nous disposerons toujours du premier element et nous pourrons 
rcmonter jusqu'au dernier. 

Enfllage 

La fonction qui ajoute un element a la file est appelee fonction « d'enfilage ». II y a 
deux cas a gerer : 

- soit la file est vide, dans ce cas on doit juste creer la file en faisant pointer premier 
vers le nouvel element cree ; 

- soit la file n'est pas vide, dans ce cas il faut parcourir toute la file en partant du 
premier element jusqu'a arriver au dernier. On rajoutera notre nouvel element apres 
le dernier. 

Voici comment on peut faire dans la pratique : 

void enfiler(File *file, int nvNombre) 
{ 

Element *nouveau = malloc(sizeof (*nouveau) ) ; 

if (file == NULL I I nouveau == NULL) 

{ 

exit (EXIT_FAILURE) ; 

} 

nouveau- >nombre = nvNombre; 
nouveau- >suivant = NULL; 

if (f ile->premier != NULL) /* La file n'est pas vide */ 
{ 

/* On se positionne a la fin de la file */ 

Element *elementActuel = f ile->premier; 

while (element Actuel->suivant != NULL) 
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{ 

elementActuel = elementActuel->suivant ; 

} 

elementActuel->suivant = nouveau; 
} 

else /* La file est vide, notre element est le premier */ 
{ 

f ile->premier = nouveau; 
} 
} 

Vous voyez dans ce code le traitement des deux cas possibles, chacun devant etre gere 
a part. La difference par rapport aux piles, qui rajoute une petite touche de difficulte, 
est qu'il faut se placer a la fin de la file pour ajouter le nouvel element. Mais bon, un 
petit while et le tour est joue, comme vous pouvez le constater. :-) 



Defilage 

Le defilage ressemble etrangement au depilage. Etant donne qu'on possede un pointeur 
vers le premier element de la file, il nous suffit de l'enlever et de renvoyer sa valeur. 

int def iler (File *file) 
{ 

if (file == NULL) 

{ 

exit(EXIT_FAILURE) ; 

} 

int nombreDefile = 0; 

/* On verifie s'il y a quelque chose a def iler */ 

if (file->premier != NULL) 

{ 

Element *elementDef ile = f ile->premier ; 

nombreDefile = elementDef ile->nombre; 
f ile->premier = elementDef ile->suivant ; 
free (elementDef ile) ; 
} 

return nombreDefile; 



A vous de jouer ! 

II resterait a ecrire une fonction aff icherFile, comme on l'avait fait pour les piles. 
Cela vous permettrait de verifier si votre file se comporte correctement. 
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Realisez ensuite un main pour faire tourner votre programme. Vous devriez pouvoir 
obtenir un rendu similaire a ceci : 

Etat de la file : 
4 8 15 16 23 42 

Je defile 4 
Je defile 8 

Etat de la file : 
15 16 23 42 



A terme, vous devriez pouvoir creer votre propre bibliotheque de files, avec des fichiers 
file .h et file . c par exemple. 

Je vous propose de telecharger le projet complet de gestion des files, si vous le desirez. 
II inclut la fonction af f icherFile. 



> [ Code web : 467879 ) 



En resume 

- Les piles et les files permettent d'organiser en memoire des donnees qui arrivent au 
fur et a mesure. 

- Elles utilisent un systeme de liste chainee pour assembler les elements. 

- Dans le cas des piles, les donnees s'ajoutent les unes au-dessus des autres. Lorsqu'on 
extrait une donnee, on recupere la derniere qui vient d'etre ajoutee (la plus recente). 
On parle d'algorithme LIFO (Last In First Out). 

- Dans les cas des files, les donnees s'ajoutent les unes a la suite des autres. On extrait 
la premiere donnee a avoir ete ajoutee dans la file (la plus ancienne). On parle 
d'algorithme FIFO (First In First Out). 
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Les tables de hachage 



Difficulty : HB 

Les listes chatnees ont un gros defaut lorsqu'on souhaite lire ce qu'elles contiennent : il 
n'est pas possible d'acceder directement a un element precis. II faut parcourir la liste 
en avancant d'element en element jusqu'a trouver celui qu'on recherche. Cela pose 
des problemes de performance des que la liste chamee devient volumineuse. Imaginez une 
liste chamee de 1 000 elements ou celui que Ton recherche est tout a la fin I 

Les tables de hachage representent une autre facon de stocker des donnees. Elles sont basees 
sur les tableaux du langage C que vous connaissez bien, dorenavant. Leur gros avantage? 
Elle permettent de retrouver instantanement un element precis, que la table contienne 100, 
1 000, 10 000 cases ou plus encore I 
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Pourquoi utiliser une table de hachage 



? 



Partons du probleme que peuvent nous poser les listes chainees. Celles-ci sont particu- 
lierement souples, nous avons pu le constater : il est possible d'ajouter ou de supprimer 
des cases a tout moment, alors qu'un tableau est « fige » une fois qu'il a ete cree. 

Toutefois, comme je vous le disais en introduction, les listes chainees ont quand meme 
un gros defaut : si on cherche a recuperer un element precis de la liste, il faut parcourir 
celle-ci en entier jusqu'a ce qu'on le retrouve! 

Imaginons une liste chainee qui contienne des informations sur des eleves : leur nom, 
leur age et leur moyenne. Chaque eleve sera represents par une structure Eleve . 

Si je veux retrouver les informations sur Luc Doncieux dans la fig. 31.1, il va falloir 
parcourir toute la liste pour se rendre compte qu'il etait a la fin ! 






NULL 



Figure 31.1 Pour retrouver Luc Doncieux dans la liste, il faut la parcourir en entier 
en analysant chaque element a partir du premier ! 




O 



Bien entendu, si on avait cherche Julien Lefebvre, cela aurait ete beaucoup 
plus rapide puisqu'il est au debut de la liste. Neanmoins, pour evaluer I'effi- 
cacite d'un algorithme 2 , on doit toujours envisager le pire des cas. Et le pire, 
c'est Luc. 



Dans cet exemple, notre liste chainee ne contient que quatre elements. L'ordinateur 
retrouvera Luc Doncieux tres rapidement avant que vous n'ayez eu le temps de dire 
« ouf ». Mais imaginez maintenant que celui-ci se trouve a la fin d'une liste chainee 
contenant 10 000 elements ! Ce n'est pas acceptable de devoir parcourir jusqu'a 10 000 
elements pour retrouver une information. C'est la que les tables de hachage entrent en 
jeu. 



Qu'est-ce qu'une table de hachage ? 

Si vous vous souvenez bien, les tableaux ne connaissaient pas ce probleme. Ainsi, pour 
acceder a l'element d'indice 2 dans mon tableau, il me suffisait d'ecrire ceci : 



1. Nous avons travaille auparavant sur des listes chainees qui contenaient des int. Comme je vous 
l'ai dit, il est possible de stocker ce qu'on veut dans une liste, meme un pointeur vers une structure 
comme je le propose ici. 

2. Ici, on dit que l'algorithme de recherche d'un element a une complexity en 0(n), car il faut 
parcourir toute la liste chainee pour retrouver un element donne, dans le pire des cas ou celui-ci est a 
la fin. Si la liste contient 9 elements, il faudra 9 iterations au maximum pour retrouver un element. 
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int tableau [4] = {12, 7, 14, 33}; 
printf ('"/.d" , tableau[2] ) ; 

Si on lui donne tableau [2] , l'ordinateur va directement a la case memoire ou se trouve 
stocke le nombre 14. II ne parcourt pas les cases du tableau une a une. 

Tu es en train de dire que les tableaux ne sont « pas si mauvais », en fait? 
1 Mais dans ce cas, on perd I'avantage des listes chaTnees qui nous permettaient 
d'ajouter et de retirer des cases a tout moment I 




o 



En effet, les listes chainees sont plus flexibles. Les tableaux, eux, permettent un acces 
plus rapide. Les tables de hachage constituent quelque part un compromis entre les 
deux. 

II y a un defaut important avec les tableaux dont on n'a pas beaucoup parle jusqu'ici : 
les cases sont identifiees par des numeros qu'on appelle des indices. II n'est pas possible 
de demander a l'ordinateur : « Dis-moi quelles sont les donnees qui se trouvent a la 
case "Luc Doncieux" ». Pour retrouver l'age et la moyenne de Luc Doncieux, on ne 
peut done pas ecrire : 

I tableau["Luc Doncieux"] ; 

Ce serait pourtant pratique de pouvoir acceder a une case du tableau rien qu'avec le 
nom! Eh bien avec les tables de hachage 3 , e'est possible. 




<? 



O 



Puisque notre tableau doit forcement etre numerate par des indices, comment 
fait-on pour retrouver le bon numero de case si on connaTt seulement le nom 
« Luc Doncieux » ? 



Bonne remarque. En effet, un tableau reste un tableau et celui-ci ne fonctionne qu'avec 
des indices numerates. Imaginez un tableau correspondant a la fig. 31.2 : chaque case 
a un indice et possede un pointeur vers une structure de type Eleve. Cela, vous savez 
deja le faire. 

Si on veut retrouver la case correspondant a Luc Doncieux, il faut pouvoir transformer 
son nom en indice du tableau. Ainsi, il faut pouvoir faire l'association entre chaque 
nom et un numero de case de tableau : 

- Julien Lefebvre = ; 

- Aurelie Bassoli = 1 ; 

- Yann Martinez = 2 ; 

- Luc Doncieux = 3. 

On ne peut ecrire tableau ["Luc Doncieux"] comme je l'ai fait precedemment. Ce 
n'est pas valide en C. 



3. Comme tout ce que nous venons de voir recemment, les tables de hachage ne font pas « partie » 
du langage C. II s'agit simplement d'un concept. On va reutiliser les briques de base du C que Ton 
connait deja pour creer un nouveau systeme intelligent. Comme quoi, en C, avec peu d'outils a la base, 
on peut creer beaucoup de choses ! 
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Indice 



Valeur 



Julien Lefebvre 
' 21 ans 
1*20 

Aurftlie Bassoli 

■ 20 ans 
16/20 

Yann Martinez 

■ 1Bans 
17/20 



Luc Doncieux 
-*- 18 ans 
11/20 



Figure 31.2 - Un simple tableau contenant des pointeurs vers des structures Eleve 

La question est : comment transformer une chaine de caracteres en numero? C'est 
toute la magie du hachage. II faut ecrire une fonction qui prend en entree une chame 
de caracteres, fait des calculs avec, puis retourne en sortie un numero correspondant a 
cette chaine. Ce numero sera l'indice de la case dans notre tableau (fig. 31.3). 



Luc Doncieux 




Valeur 



Julien Lefebvre 
"21 ans 
14/20 



Aurelie Bassoli 
-»- 20 ans 
15/20 



Yann Martinez 

• ISans 
17/20 



Luc Doncieux 

-*■ ISans 
11/20 



Figure 31.3 - La fonction de hachage genere un indice correspondant au nom envoye 
en parametre 



Ecrire une fonction de hachage 

Toute la difRculte consiste a ecrire une fonction de hachage correcte. Comment tran- 
former une chaine de caracteres en un nombre unique ? 

Tout d'abord, mettons les choses au clair : une table de hachage ne contient pas 4 cases 
comme sur mes exemples, mais plutot 100, 1 000 ou meme plus. Peu importe la taille 
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du tableau, la recherche de l'element sera aussi rapide 4 . 

Imaginons done un tableau de 100 cases dans lequel on va stocker des pointeurs vers 
des structures Eleve. 

|Eleve* tableau [100] ; 

Nous devons ecrire une fonction qui, a partir d'un nom, genere un nombre compris 
entre et 99 (les indices du tableau). C'est la qu'il faut etre inventif. II existe des 
methodes mathematiques tres complexes 5 pour « hacher » des donnees, e'est-a-dire les 
transformer en nombres. 

Vous pouvez inventer votre propre fonction de hachage. Ici, pour faire simple, je vous 
propose tout simplement d'additionner les valeurs ASCII de chaque lettre du nom, 
e'est-a-dire pour Luc Doncieux faire la somme suivante : 

I 'L' + 'u' + 'c' + ' ' + 'D' + 'o' + 'n' + 'c' + 'i' + 'e' + 'u' + 'x' 

On va toutefois avoir un probleme : cette somme depasse 100 6 ! Comme notre tableau 
ne fait que 100 cases, si on s'en tient a <ja, on risque de sortir des limites du tableau. 

Pour regler le probleme, on peut utiliser l'operateur modulo '/,. Vous vous souvenez de 
lui ? II donne le reste de la division ! Si on fait le calcul : 

I sommeLettres '/, 100 

... on obtiendra forcement un nombre compris entre et 99. Par exemple, si la somme 
fait 4315, le reste de la division par 100 est 15. La fonction de hachage retournera done 
15. 

Voici a quoi pourrait ressembler cette fameuse fonction : 

int hachage (char *chaine) 
{ 

int i = 0, nombreHache = 0; 

for (i = ; chained] != '\0' ; i++) 
{ 

nombreHache += chaine [i] ; 
} 
nombreHache '/,= 100 ; 

return nombreHache ; 



4. On dit que c'est une complexity en O(l) car on trouve directement l'element que Ton recherche. 
En effet, la fonction de hachage nous retourne un indice : il suffit de « sauter » directement a la case 
correspondante du tableau. Plus besoin de parcourir toutes les cases ! 

5. Les algorithmes MD5 et SHA1 sont des fonctions de hachage celebres, mais elles sont trop 
poussees pour nous ici. 

6. Je vous rappelle que chaque lettre dans la table ASCII peut ef re numerotee jusqu'a 255. On a 
done vite fait de depasser 100. 
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Si on lui envoie hachage("Luc Doncieux"), elle renvoie 55. Avec hachage("Yann 
Martinez"), on obtient 80. 

Grace a cette fonction de hachage, vous savez done dans quelle case de votre tableau 
vous devez placer vos donnees ! Lorsque vous voudrez y acceder plus tard pour en 
recuperer les donnees, il suffira de hacher a nouveau le nom de la personne 7 pour 
retrouver l'indice de la case du tableau ou sont stockees les informations ! 



Gerer les collisions 

Quand la fonction de hachage renvoie le meme nombre pour deux cles differentes, on 
dit qu'il y a collision. Par exemple dans notre cas, si nous avions un anagramme de 
Luc Doncieux qui s'appelle Luc Doncueix, la somme des lettres est la meme, done le 
resultat de la fonction de hachage sera le meme ! 

Deux raisons peuvent expliquer une collision. 

- La fonction de hachage n'est pas tres performante 8 . C'est notre cas. Nous avons ecrit 
une fonction tres simple (mais neanmoins sufRsante) pour nos exemples. 

- Le tableau dans lequel on stocke nos donnees est trop petit. Si on cree un tableau 
de 4 cases et qu'on souhaite stocker 5 personnes, on aura a coup sur une collision, 
e'est-a-dire que notre fonction de hachage donnera le meme indice pour deux noms 
differents. 

Si une collision survient, pas de panique! Deux solutions s'offrent a vous au choix : 
l'adressage ouvert et le chainage. 

L'adressage ouvert 

S'il reste de la place dans votre tableau, vous pouvez utiliser la technique dite du 
hachage lineaire. Le principe est simple. La case est occupee ? Pas de probleme, allez 
a la case suivante. Ah, elle est occupee aussi ? Allez a la suivante ! 

Ainsi de suite, continuez jusqu'a trouver la prochaine case libre dans le tableau. Si vous 
arrivez a la fin du tableau, retournez a la premiere case et continuez. 

Cette methode est tres simple a mettre en place, mais si vous avez beaucoup de colli- 
sions, vous allez passer beaucoup de temps a chercher la prochaine case libre. 

II existe des variantes (hachage double, hachage quadratique. . .) qui consistent a hacher 
a nouveau selon une autre fonction en cas de collision. Elles sont plus efficaces mais 
plus complexes a mettre en place. 



7. Je vous recommande de creer une fonction de recherche qui se chargera de hacher la cle (le nom) 
et de vous renvoyer un pointeur vers les donnees que vous recherchiez. Cela donnerait par exemple : 
infosSurLuc = rechercheTableHachage(tableau, "Luc Doncieux"); 

8. Les fonctions MD5 et SHA1 mentionnees plus t6t sont de bonne qualite car elles produisent 
tres peu de collisions. Notez que SHA1 est aujourd'hui preferee a MD5 car c'est celle des deux qui en 
produit le moins. 
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Le chainage 

Une autre solution consiste a creer une liste chainee a l'emplacement de la collision. 
Vous avez deux donnees (ou plus) a stocker dans la meme case ? Utilisez une liste 
chainee et creez un pointeur vers cette liste depuis le tableau (fig. 31.4). 



Indice 



Valeur 



Figure 31.4 
chainee ! 



Si deux elements doivent etre stockes au meme endroit, creez une liste 



Bien entendu, on en revient au defaut des listes chainees : s'il y a 300 elements a cet 
emplacement du tableau, il va falloir parcourir la liste chainee jusqu'a trouver le bon. 

Ici, comme vous le voyez, tout est affaire de compromis. Les listes chainees ne sont pas 
toujours ideales, mais les tables de hachage ont aussi leurs limites. On peut combiner 
les deux pour tenter de tirer le meilleur de chacune de ces structures de donnees. 

Quoi qu'il en soit, le point critique dans une table de hachage est la fonction de hachage. 
Moins elle produit de collisions, mieux c'est. A vous de trouver la fonction de hachage 
qui convient le mieux a votre cas ! 

En resume 

- Les listes chainees sont flexibles, mais il peut etre long de retrouver un element precis 
a l'interieur car il faut les parcourir case par case. 

- Les tables de hachage sont des tableaux. On y stocke des donnees a un emplacement 
determine par une fonction de hachage. 

- La fonction de hachage prend en entree une cle (ex. : une chaine de caracteres) et 
retourne en sortie un nombre. 

- Ce nombre est utilise pour determiner a quel indice du tableau sont stockees les 
donnees. 

- Une bonne fonction de hachage doit produire peu de collisions, c'est-a-dire qu'elle 
doit eviter de renvoyer le meme nombre pour deux cles differentes. 

- En cas de collision, on peut utiliser l'adressage ouvert (recherche d'une autre case 
libre dans le tableau) ou bien le chainage (combinaison avec une liste chainee). 
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